@qduc/term2 0.22.1 → 0.24.0

package/dist/tools/system/run-code/run-code-runtime-contract.d.ts

@@ -0,0 +1,20 @@
+import type { RunCodeDiagnosticCode } from './run-code-execution.js';
+/** Terminal semantic outcome of one observed nested action call. */
+export type RunCodeActionOutcome = 'applied' | 'not_applied' | 'failed' | 'unknown';
+/** Host-observed evidence for one nested action call. */
+export interface RunCodeActionReceipt {
+    readonly callId: string;
+    readonly tool: string;
+    readonly outcome: RunCodeActionOutcome;
+    readonly reason?: string;
+}
+/** One tools.* call observed during a runtime invocation. */
+export interface RunCodeCallRecord {
+    readonly callId?: string;
+    readonly tool: string;
+    readonly outcome: 'ok' | 'error' | 'approval_required' | 'unknown_policy' | 'policy_error' | 'interceptor_denied' | 'unknown_tool' | 'invalid_params' | 'prohibited' | 'describe' | 'unknown';
+    readonly durationMs: number;
+    readonly directlyCallable?: boolean;
+    readonly diagnostic?: RunCodeDiagnosticCode;
+}
+//# sourceMappingURL=run-code-runtime-contract.d.ts.map

package/dist/tools/system/run-code/run-code-runtime-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-code-runtime-contract.d.ts","sourceRoot":"","sources":["../../../../source/tools/system/run-code/run-code-runtime-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpF,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EACZ,IAAI,GACJ,OAAO,GACP,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,SAAS,CAAC;IACd,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CAC7C"}

package/dist/tools/system/run-code/run-code-runtime-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-code-runtime-contract.js.map

package/dist/tools/system/run-code/run-code-runtime-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-code-runtime-contract.js","sourceRoot":"","sources":["../../../../source/tools/system/run-code/run-code-runtime-contract.ts"],"names":[],"mappings":""}

package/dist/tools/system/run-code/run-code-runtime.d.ts

@@ -0,0 +1,99 @@
+import type { ExecutionContext } from '../../../services/execution-context.js';
+import type { JsonValue } from '../../../services/sandboxed-code-host/host-types.js';
+import type { ILoggingService } from '../../../services/service-interfaces.js';
+import type { ToolApprovalPolicyRegistry } from '../../../services/approval/tool-approval-policy-registry.js';
+import type { NestedApprovalOwner } from '../../../services/approval/nested-approval-owner.js';
+import { type AnyToolDefinition, type ToolRegistry } from '../../types.js';
+import type { RunCodeActionOutcome } from './run-code-runtime-contract.js';
+export type { RunCodeActionOutcome, RunCodeActionReceipt, RunCodeCallRecord } from './run-code-runtime-contract.js';
+export declare const TOOL_NAME_RUN_CODE = "run_code";
+export declare const TOOL_NAME_DESCRIBE = "describe";
+/** Limits governing one script invocation. */
+export declare const RUN_CODE_LIMITS: {
+    readonly maxCalls: 200;
+    readonly maxConcurrency: 8;
+    readonly maxResultChars: 100000;
+    readonly maxMediaBytes: number;
+    readonly maxMediaTotalBytes: number;
+    readonly maxMediaAttachments: 32;
+    readonly maxCodeBytes: 65536;
+    readonly maxOutputBytes: 262144;
+    readonly maxConsoleBytes: 262144;
+};
+/** Tools that are structurally unavailable from a script. */
+export declare const RUN_CODE_PROHIBITED_TOOLS: ReadonlySet<string>;
+/** Static semantic adapters for action tools whose result contract is known. */
+export declare const ACTION_SEMANTICS: Record<string, (raw: unknown) => {
+    outcome: RunCodeActionOutcome;
+    reason?: string;
+}>;
+export declare const isActionTool: (name: string) => boolean;
+export declare const clipReason: (reason: string) => string;
+export declare function isDirectlyCallable(tool: Pick<AnyToolDefinition, 'name'>): boolean;
+export declare function describeTool(tool: AnyToolDefinition): JsonValue;
+export declare function createMediaReferenceStore(): {
+    capture: (value: unknown) => unknown;
+    resolve: (value: unknown) => unknown;
+};
+export declare const serializeResult: (result: unknown, limit: number, toolName: string, callsCompleted: number) => Promise<{
+    ok: true;
+    result: JsonValue;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function getConversationSessionId(context: unknown): string | undefined;
+export declare function writeNestedCallRecord(tool: string, sessionId: string | undefined, outcome: 'success' | 'failure' | 'denied-by-approval'): void;
+type BoundAuthority = {
+    kind: 'bound';
+    physicalRoot: string;
+    params: unknown;
+} | {
+    kind: 'denied';
+    message: string;
+};
+export declare function bindPreparedAuthority(toolName: string, params: unknown, cwd: string, executionContext?: ExecutionContext): Promise<BoundAuthority>;
+export declare function withAbortSignal(context: unknown, signal: AbortSignal, extra?: Record<string, unknown>): unknown;
+export declare function mergeAbortSignals(callerSignal: AbortSignal | undefined, hostSignal: AbortSignal): AbortSignal;
+export declare function isParallelSafe(tool: AnyToolDefinition, params: unknown, context: unknown): Promise<boolean>;
+import { type RunCodeExecution } from './run-code-execution.js';
+export interface RunCodeRuntimeOptions {
+    registry: ToolRegistry;
+    /** Identity of the complete wrapped graph used by approval revalidation. */
+    graphIdentity?: object;
+    loggingService: ILoggingService;
+    approvalPolicyRegistry: ToolApprovalPolicyRegistry;
+    getCwd: () => string;
+    executionContext?: ExecutionContext;
+    nestedApprovalOwner?: NestedApprovalOwner;
+    sessionAccess?: import('../../../services/session/session-access-state.js').SessionAccessState;
+    nestedCompatibility?: import('../../../services/session/nested-tool-compatibility-state.js').NestedToolCompatibilityState;
+}
+export interface RunCodeRuntimeInput {
+    code: string;
+    inputs: Record<string, JsonValue>;
+    timeout: number;
+    description: string;
+    context?: unknown;
+    signal?: AbortSignal;
+}
+export interface RunCodeRuntimeResult {
+    execution: RunCodeExecution;
+    /** Raw console projection retained for terminal presentation. */
+    output: readonly string[];
+}
+/**
+ * Product-specific runtime for one final wrapped registry snapshot.
+ *
+ * The host remains deliberately product-neutral. This module owns the other
+ * half of the seam: discovery of scriptable members, nested admission and
+ * approval, call/action ledgers, attachment references, normalization, and
+ * completion telemetry. Consequently a caller cannot accidentally execute
+ * only half of the lifecycle (for example, admit calls without finalizing
+ * receipts) by assembling the pieces itself.
+ */
+export declare function createRunCodeRuntime(options: RunCodeRuntimeOptions): {
+    discovery: () => ToolRegistry;
+    execute: (input: RunCodeRuntimeInput) => Promise<RunCodeRuntimeResult>;
+};
+//# sourceMappingURL=run-code-runtime.d.ts.map

package/dist/tools/system/run-code/run-code-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-code-runtime.d.ts","sourceRoot":"","sources":["../../../../source/tools/system/run-code/run-code-runtime.ts"],"names":[],"mappings":"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"}