nsmcp::QuestionService method forget (public)

 <instance of nsmcp::QuestionService> forget context handle

Defined in /usr/local/ns/tcl/nsmcp/question-service.tcl

Remove an owned conversation and its retained evidence. Reject active work when required and clean up private evidence with the retained conversation state.

Parameters:

context (required)

Authenticated request context carrying the principal, grants and selected server.

handle (required)

Retained job or conversation handle; ownership and expiry checks still apply.

Returns:

The deletion result.

Testcases:

No testcase defined.

Source code:

ns_mutex lock ${:mutex}
try {
    set record [:owned $context $handle]
    if {[dict get $record status] in {queued running cancelling}} {
        error "Cancel the running question before starting a new conversation"
    }
    :drop $handle
} finally {
    ns_mutex unlock ${:mutex}
}
return {{} object {status string forgotten}}

XQL Not present:

Generic, PostgreSQL, Oracle