@namzu/sdk 0.1.1

package/dist/runtime/query/executor.d.ts

@@ -0,0 +1,35 @@
+import type { ToolRegistry } from "../../registry/tool/execute.js";
+import type { ActivityStore } from "../../store/activity/memory.js";
+import type { RunId } from "../../types/ids/index.js";
+import { type Message } from "../../types/message/index.js";
+import type { PermissionMode } from "../../types/permission/index.js";
+import type { ChatCompletionResponse } from "../../types/provider/index.js";
+import type { RunEvent } from "../../types/run/index.js";
+import type { Logger } from "../../utils/logger.js";
+export type EmitEvent = (event: RunEvent) => Promise<void>;
+export interface ToolExecutorConfig {
+    tools: ToolRegistry;
+    runId: RunId;
+    workingDirectory: string;
+    permissionMode: PermissionMode;
+    env: Record<string, string>;
+    abortSignal: AbortSignal;
+}
+export interface ToolExecutionBatch {
+    messages: Message[];
+    results: Array<{
+        toolCallId: string;
+        output: string;
+    }>;
+}
+export declare class ToolExecutor {
+    private config;
+    private activityStore;
+    private emitEvent;
+    private log;
+    constructor(config: ToolExecutorConfig, activityStore: ActivityStore, emitEvent: EmitEvent, log: Logger);
+    executeBatch(response: ChatCompletionResponse): Promise<ToolExecutionBatch>;
+    private buildToolContext;
+    private executeSingle;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/runtime/query/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,8BAA8B,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,GAAG,CAAS;gBAGnB,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM;IAQN,YAAY,CACjB,QAAQ,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAyB9B,OAAO,CAAC,gBAAgB;YAgBV,aAAa;CAmF3B"}

package/dist/runtime/query/executor.js

@@ -0,0 +1,110 @@
+import { createToolMessage } from "../../types/message/index.js";
+export class ToolExecutor {
+    config;
+    activityStore;
+    emitEvent;
+    log;
+    constructor(config, activityStore, emitEvent, log) {
+        this.config = config;
+        this.activityStore = activityStore;
+        this.emitEvent = emitEvent;
+        this.log = log;
+    }
+    async executeBatch(response) {
+        const toolCalls = response.message.toolCalls;
+        if (!toolCalls) {
+            return { messages: [], results: [] };
+        }
+        this.log.debug('Executing tool batch', {
+            runId: this.config.runId,
+            toolCount: toolCalls.length,
+            tools: toolCalls.map((tc) => tc.function.name),
+        });
+        const toolContext = this.buildToolContext();
+        const results = await Promise.all(toolCalls.map((toolCall) => this.executeSingle(toolCall, toolContext)));
+        const messages = results.map((r) => createToolMessage(r.output, r.toolCallId));
+        return { messages, results };
+    }
+    buildToolContext() {
+        return {
+            runId: this.config.runId,
+            workingDirectory: this.config.workingDirectory,
+            abortSignal: this.config.abortSignal,
+            env: this.config.env,
+            log: (level, message) => this.log[level](message),
+            permissionContext: {
+                mode: this.config.permissionMode,
+                sessionId: this.config.runId,
+                workingDirectory: this.config.workingDirectory,
+            },
+            toolRegistry: this.config.tools,
+        };
+    }
+    async executeSingle(toolCall, toolContext) {
+        const toolName = toolCall.function.name;
+        let input;
+        try {
+            input = JSON.parse(toolCall.function.arguments);
+        }
+        catch {
+            return {
+                toolCallId: toolCall.id,
+                output: `Error: Invalid JSON in tool arguments for "${toolName}"`,
+            };
+        }
+        const activity = this.activityStore.create({
+            type: "tool_call",
+            description: toolName,
+            input,
+            toolName,
+            toolCallId: toolCall.id,
+        });
+        if (activity) {
+            this.activityStore.start(activity.id);
+        }
+        await this.emitEvent({
+            type: "tool_executing",
+            runId: this.config.runId,
+            toolName,
+            input,
+        });
+        const startMs = Date.now();
+        const result = await this.config.tools.execute(toolName, input, toolContext);
+        const durationMs = Date.now() - startMs;
+        const output = result.success
+            ? result.output
+            : `Error: ${result.error ?? "Tool execution failed"}`;
+        if (result.success) {
+            this.log.debug('Tool executed successfully', {
+                runId: this.config.runId,
+                tool: toolName,
+                durationMs,
+                outputLength: output.length,
+            });
+        }
+        else {
+            this.log.warn('Tool execution failed', {
+                runId: this.config.runId,
+                tool: toolName,
+                durationMs,
+                error: result.error ?? 'unknown',
+            });
+        }
+        if (activity) {
+            if (result.success) {
+                this.activityStore.complete(activity.id, output);
+            }
+            else {
+                this.activityStore.fail(activity.id, result.error ?? "Tool execution failed");
+            }
+        }
+        await this.emitEvent({
+            type: "tool_completed",
+            runId: this.config.runId,
+            toolName,
+            result: output,
+        });
+        return { toolCallId: toolCall.id, output };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/runtime/query/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/runtime/query/executor.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/guard.d.ts

@@ -0,0 +1,21 @@
+import type { StopReason } from '../../types/run/index.js';
+import type { RunPersistence } from '../../manager/run/persistence.js';
+export interface GuardConfig {
+    tokenBudget: number;
+    timeoutMs: number;
+    costLimitUsd?: number;
+    maxIterations?: number;
+}
+export interface GuardCheckResult {
+    shouldStop: boolean;
+    forceFinalize: boolean;
+    stopReason?: StopReason;
+    isCancelled: boolean;
+}
+export declare class GuardCoordinator {
+    private limitConfig;
+    private startTime;
+    constructor(config: GuardConfig);
+    beforeIteration(sessionMgr: RunPersistence, abortSignal: AbortSignal): GuardCheckResult;
+}
+//# sourceMappingURL=guard.d.ts.map

package/dist/runtime/query/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,0BAA0B,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAGtE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,SAAS,CAAQ;gBAEb,MAAM,EAAE,WAAW;IAU/B,eAAe,CACb,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,WAAW,GACvB,gBAAgB;CAmCpB"}

package/dist/runtime/query/guard.js

@@ -0,0 +1,41 @@
+import { checkLimitsDetailed, buildLimitConfig } from '../../run/LimitChecker.js';
+export class GuardCoordinator {
+    limitConfig;
+    startTime;
+    constructor(config) {
+        this.limitConfig = buildLimitConfig(config.tokenBudget, config.timeoutMs, config.costLimitUsd, config.maxIterations);
+        this.startTime = Date.now();
+    }
+    beforeIteration(sessionMgr, abortSignal) {
+        const limitState = {
+            aborted: abortSignal.aborted,
+            totalTokens: sessionMgr.tokenUsage.totalTokens,
+            totalCost: sessionMgr.costInfo.totalCost,
+            currentIteration: sessionMgr.currentIteration,
+            startTime: this.startTime,
+        };
+        const limitResult = checkLimitsDetailed(this.limitConfig, limitState);
+        if (limitResult.type === 'hard_stop') {
+            return {
+                shouldStop: true,
+                forceFinalize: false,
+                stopReason: limitResult.reason,
+                isCancelled: limitResult.reason === 'cancelled',
+            };
+        }
+        if (limitResult.type === 'warning') {
+            return {
+                shouldStop: false,
+                forceFinalize: true,
+                stopReason: limitResult.reason,
+                isCancelled: false,
+            };
+        }
+        return {
+            shouldStop: false,
+            forceFinalize: false,
+            isCancelled: false,
+        };
+    }
+}
+//# sourceMappingURL=guard.js.map

package/dist/runtime/query/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../src/runtime/query/guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAgBxG,MAAM,OAAO,gBAAgB;IACnB,WAAW,CAAoB;IAC/B,SAAS,CAAQ;IAEzB,YAAY,MAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,gBAAgB,CACjC,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,aAAa,CACrB,CAAA;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC7B,CAAC;IAED,eAAe,CACb,UAA0B,EAC1B,WAAwB;QAExB,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,WAAW;YAC9C,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS;YACxC,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;YAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;QAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;QAErE,IAAI,WAAW,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrC,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,aAAa,EAAE,KAAK;gBACpB,UAAU,EAAE,WAAW,CAAC,MAAM;gBAC9B,WAAW,EAAE,WAAW,CAAC,MAAM,KAAK,WAAW;aAChD,CAAA;QACH,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,aAAa,EAAE,IAAI;gBACnB,UAAU,EAAE,WAAW,CAAC,MAAM;gBAC9B,WAAW,EAAE,KAAK;aACnB,CAAA;QACH,CAAC;QAED,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,KAAK;SACnB,CAAA;IACH,CAAC;CACF"}

package/dist/runtime/query/index.d.ts

@@ -0,0 +1,51 @@
+import type { AgentRun, AgentRunConfig, RunEvent, RunEventListener } from '../../types/run/index.js';
+import type { LLMProvider } from '../../types/provider/index.js';
+import type { ModelPricing } from '../../utils/cost.js';
+import type { AgentPersona } from '../../types/persona/index.js';
+import type { Skill } from '../../types/skills/index.js';
+import type { ToolRegistry } from '../../registry/tool/execute.js';
+import type { ResumeHandler, CheckpointId } from '../../types/hitl/index.js';
+import type { ThreadId, RunId } from '../../types/ids/index.js';
+import type { AgentContextLevel } from '../../types/agent/factory.js';
+import type { RuntimeToolOverrides } from '../../types/agent/base.js';
+import type { TaskStore } from '../../types/task/index.js';
+import type { ContextCache } from './context-cache.js';
+import { type Message } from '../../types/message/index.js';
+export interface QueryParams {
+    systemPrompt?: string;
+    persona?: AgentPersona;
+    skills?: Skill[];
+    basePrompt?: string;
+    provider: LLMProvider;
+    tools: ToolRegistry;
+    sessionConfig: AgentRunConfig;
+    allowedTools?: string[];
+    agentId: string;
+    agentName: string;
+    workingDirectory?: string;
+    pricing?: ModelPricing;
+    enableActivityTracking?: boolean;
+    messages: Message[];
+    signal?: AbortSignal;
+    resumeHandler: ResumeHandler;
+    resumeFromCheckpoint?: CheckpointId;
+    threadId: ThreadId;
+    runId?: RunId;
+    parentRunId?: RunId;
+    depth?: number;
+    contextCache?: ContextCache;
+    contextLevel?: AgentContextLevel;
+    continuationMode?: boolean;
+    taskStore?: TaskStore;
+    runtimeToolOverrides?: RuntimeToolOverrides;
+    taskGateway?: import('../../types/agent/gateway.js').TaskGateway;
+    launchedTasks?: Map<import('../../types/ids/index.js').TaskId, import('./iteration/phases/context.js').LaunchedTaskMeta>;
+    onContextCreated?: (ctx: {
+        planManager: import('../../manager/plan/lifecycle.js').PlanManager;
+    }) => void;
+}
+export declare function query(params: QueryParams): AsyncGenerator<RunEvent, AgentRun>;
+export declare function drainQuery(params: Omit<QueryParams, 'resumeHandler'> & {
+    resumeHandler?: ResumeHandler;
+}, listener?: RunEventListener): Promise<AgentRun>;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,gBAAgB,EACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAItD,OAAO,EAAE,KAAK,OAAO,EAAuB,MAAM,8BAA8B,CAAA;AAgBhF,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,YAAY,CAAA;IACnB,aAAa,EAAE,cAAc,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,aAAa,EAAE,aAAa,CAAA;IAC5B,oBAAoB,CAAC,EAAE,YAAY,CAAA;IAEnC,QAAQ,EAAE,QAAQ,CAAA;IAElB,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAEhC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAE1B,SAAS,CAAC,EAAE,SAAS,CAAA;IAErB,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAE3C,WAAW,CAAC,EAAE,OAAO,8BAA8B,EAAE,WAAW,CAAA;IAEhE,aAAa,CAAC,EAAE,GAAG,CAAC,OAAO,0BAA0B,EAAE,MAAM,EAAE,OAAO,+BAA+B,EAAE,gBAAgB,CAAC,CAAA;IAExH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,WAAW,EAAE,OAAO,iCAAiC,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAA;CACzG;AAED,wBAAuB,KAAK,CAC1B,MAAM,EAAE,WAAW,GAClB,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAyNpC;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,EAC9E,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAgBnB"}

package/dist/runtime/query/index.js

@@ -0,0 +1,211 @@
+import { buildTaskTools } from '../../tools/task/index.js';
+import { SearchToolsTool } from '../../tools/builtins/search-tools.js';
+import { autoApproveHandler } from '../../types/hitl/index.js';
+import { createSystemMessage } from '../../types/message/index.js';
+import { getTracer } from '../../provider/telemetry/setup.js';
+import { GENAI, NAMZU, agentSessionSpanName, } from '../../telemetry/attributes.js';
+import { RunContextFactory } from './context.js';
+import { PromptBuilder } from './prompt.js';
+import { ToolingBootstrap } from './tooling.js';
+import { GuardCoordinator } from './guard.js';
+import { EventTranslator } from './events.js';
+import { IterationOrchestrator } from './iteration/index.js';
+import { ResultAssembler } from './result.js';
+import { CheckpointManager } from './checkpoint.js';
+export async function* query(params) {
+    const ctx = RunContextFactory.build({
+        agentId: params.agentId,
+        agentName: params.agentName,
+        sessionConfig: params.sessionConfig,
+        provider: params.provider,
+        workingDirectory: params.workingDirectory,
+        pricing: params.pricing,
+        enableActivityTracking: params.enableActivityTracking,
+        messages: params.messages,
+        signal: params.signal,
+        threadId: params.threadId,
+        runId: params.runId,
+        parentRunId: params.parentRunId,
+        depth: params.depth,
+    });
+    ctx.planManager.setApprovalHandler(async (request) => {
+        const decision = await params.resumeHandler({
+            type: 'plan_approval',
+            runId: ctx.runId,
+            checkpointId: `cp_plan_${request.planId}`,
+            plan: {
+                planId: request.planId,
+                title: request.title,
+                steps: request.steps.map((s, i) => ({
+                    id: s.id,
+                    description: s.description,
+                    toolName: s.toolName,
+                    dependsOn: s.dependsOn,
+                    order: s.order ?? i + 1,
+                })),
+                summary: request.summary,
+            },
+        });
+        if (decision.action === 'approve_plan') {
+            return { approved: true };
+        }
+        if (decision.action === 'reject_plan') {
+            return { approved: false, feedback: decision.feedback };
+        }
+        return { approved: false, feedback: `Action: ${decision.action}` };
+    });
+    params.onContextCreated?.({ planManager: ctx.planManager });
+    const eventTranslator = new EventTranslator(ctx.sessionMgr);
+    eventTranslator.wireActivityStore(ctx.activityStore, ctx.runId);
+    eventTranslator.wirePlanManager(ctx.planManager, ctx.runId);
+    const unsubscribeTaskStore = params.taskStore
+        ? eventTranslator.wireTaskStore(params.taskStore, ctx.runId)
+        : undefined;
+    if (params.taskStore) {
+        const taskTools = buildTaskTools(params.taskStore, ctx.runId);
+        const overrides = params.runtimeToolOverrides;
+        for (const tool of taskTools) {
+            const override = overrides?.[tool.name];
+            if (override === 'disabled')
+                continue;
+            params.tools.register(tool, override ?? 'deferred');
+        }
+    }
+    if (!params.tools.has(SearchToolsTool.name)) {
+        const hasDeferred = params.tools.listNames().some((n) => params.tools.getAvailability(n) === 'deferred');
+        if (hasDeferred) {
+            params.tools.register(SearchToolsTool);
+        }
+    }
+    const toolExecutor = ToolingBootstrap.init({
+        tools: params.tools,
+        runId: ctx.runId,
+        workingDirectory: ctx.cwd,
+        permissionMode: ctx.permissionMode,
+        env: params.sessionConfig.env ?? {},
+        abortSignal: ctx.abortController.signal,
+    }, ctx.activityStore, eventTranslator.emitEvent, ctx.log);
+    const promptBuilder = new PromptBuilder({
+        systemPrompt: params.systemPrompt,
+        persona: params.persona,
+        skills: params.skills,
+        basePrompt: params.basePrompt,
+        tools: params.tools,
+        allowedTools: params.allowedTools,
+    });
+    const guard = new GuardCoordinator({
+        tokenBudget: params.sessionConfig.tokenBudget,
+        timeoutMs: params.sessionConfig.timeoutMs,
+        costLimitUsd: params.sessionConfig.costLimitUsd,
+        maxIterations: params.sessionConfig.maxIterations,
+    });
+    const checkpointMgr = new CheckpointManager(ctx.sessionMgr.getRunStore());
+    const resultAssembler = new ResultAssembler({
+        sessionMgr: ctx.sessionMgr,
+        planManager: ctx.planManager,
+        activityStore: ctx.activityStore,
+        log: ctx.log,
+        emitEvent: eventTranslator.emitEvent,
+        drainPending: () => eventTranslator.drainPending(),
+    });
+    const iterationOrchestrator = new IterationOrchestrator({
+        provider: params.provider,
+        sessionConfig: params.sessionConfig,
+        tools: params.tools,
+        allowedTools: params.allowedTools,
+        taskGateway: params.taskGateway,
+        taskStore: params.taskStore,
+        launchedTasks: params.launchedTasks,
+    }, ctx.sessionMgr, toolExecutor, guard, ctx.activityStore, eventTranslator.emitEvent, () => eventTranslator.drainPending(), ctx.abortController, ctx.log, params.resumeHandler, checkpointMgr, ctx.planManager);
+    const tracer = getTracer();
+    return yield* (async function* () {
+        const rootSpan = tracer.startSpan(agentSessionSpanName(params.agentName));
+        rootSpan.setAttributes({
+            [NAMZU.SESSION_ID]: ctx.sessionMgr.id,
+            [GENAI.AGENT_NAME]: params.agentName,
+            [GENAI.AGENT_ID]: params.agentId,
+            [GENAI.REQUEST_MODEL]: params.sessionConfig.model,
+            [GENAI.SYSTEM]: params.provider.id,
+        });
+        try {
+            await ctx.sessionMgr.init();
+            ctx.log.info('Starting query', {
+                runId: ctx.sessionMgr.id,
+                agent: params.agentName,
+                model: params.sessionConfig.model,
+                tokenBudget: params.sessionConfig.tokenBudget,
+                activityTracking: ctx.activityStore.enabled,
+                permissionMode: ctx.permissionMode,
+                resumeFromCheckpoint: params.resumeFromCheckpoint ?? null,
+            });
+            const contextLevel = params.contextLevel ?? 'full';
+            const assembledPrompt = params.contextCache
+                ? params.contextCache.getSystemPrompt({
+                    systemPrompt: params.systemPrompt,
+                    persona: params.persona,
+                    skills: params.skills,
+                    basePrompt: contextLevel === 'full' ? params.basePrompt : undefined,
+                    tools: params.tools,
+                    allowedTools: params.allowedTools,
+                })
+                : promptBuilder.build(contextLevel, params.workingDirectory);
+            if (params.resumeFromCheckpoint) {
+                const checkpoint = await checkpointMgr.restore(params.resumeFromCheckpoint);
+                await eventTranslator.emitEvent({
+                    type: 'run_resuming',
+                    runId: ctx.sessionMgr.id,
+                    fromCheckpointId: checkpoint.id,
+                });
+                yield* eventTranslator.drainPending();
+                ctx.sessionMgr.pushMessage(createSystemMessage(assembledPrompt));
+                for (const msg of checkpoint.messages) {
+                    if (msg.role === 'system')
+                        continue;
+                    ctx.sessionMgr.pushMessage(msg);
+                }
+            }
+            else if (params.continuationMode) {
+                for (const msg of params.messages) {
+                    ctx.sessionMgr.pushMessage(msg);
+                }
+            }
+            else {
+                ctx.sessionMgr.pushMessage(createSystemMessage(assembledPrompt));
+                for (const msg of params.messages) {
+                    if (msg.role === 'system')
+                        continue;
+                    ctx.sessionMgr.pushMessage(msg);
+                }
+            }
+            ctx.sessionMgr.markRunning();
+            await eventTranslator.emitEvent({ type: 'run_started', runId: ctx.sessionMgr.id, systemPrompt: assembledPrompt });
+            yield* eventTranslator.drainPending();
+            yield* iterationOrchestrator.runLoop();
+            yield* resultAssembler.completeRun(rootSpan);
+        }
+        catch (err) {
+            yield* resultAssembler.handleError(err, rootSpan);
+        }
+        finally {
+            unsubscribeTaskStore?.();
+            rootSpan.end();
+        }
+        return await resultAssembler.finalize();
+    })();
+}
+export async function drainQuery(params, listener) {
+    const fullParams = {
+        ...params,
+        resumeHandler: params.resumeHandler ?? autoApproveHandler,
+    };
+    const gen = query(fullParams);
+    let result = await gen.next();
+    while (!result.done) {
+        if (listener) {
+            await listener(result.value);
+        }
+        result = await gen.next();
+    }
+    return result.value;
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/query/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/iteration/index.d.ts

@@ -0,0 +1,34 @@
+import type { PlanManager } from "../../../manager/plan/lifecycle.js";
+import type { RunPersistence } from "../../../manager/run/persistence.js";
+import type { ToolRegistry } from "../../../registry/tool/execute.js";
+import type { ActivityStore } from "../../../store/activity/memory.js";
+import type { ResumeHandler } from "../../../types/hitl/index.js";
+import type { LLMProvider } from "../../../types/provider/index.js";
+import type { AgentRunConfig, RunEvent } from "../../../types/run/index.js";
+import type { Logger } from "../../../utils/logger.js";
+import type { CheckpointManager } from "../checkpoint.js";
+import type { EmitEvent } from "../events.js";
+import type { ToolExecutor } from "../executor.js";
+import type { GuardCoordinator } from "../guard.js";
+export type { IterationContext } from "./phases/index.js";
+export type { PhaseSignal } from "./phases/index.js";
+export type { ToolReviewOutcome } from "./phases/index.js";
+export interface IterationConfig {
+    provider: LLMProvider;
+    sessionConfig: AgentRunConfig;
+    tools: ToolRegistry;
+    allowedTools?: string[];
+    taskGateway?: import('../../../types/agent/gateway.js').TaskGateway;
+    taskStore?: import('../../../types/task/index.js').TaskStore;
+    launchedTasks?: Map<import('../../../types/ids/index.js').TaskId, import('./phases/context.js').LaunchedTaskMeta>;
+}
+export declare class IterationOrchestrator {
+    private ctx;
+    constructor(config: IterationConfig, sessionMgr: RunPersistence, toolExecutor: ToolExecutor, guard: GuardCoordinator, activityStore: ActivityStore, emitEvent: EmitEvent, drainPending: () => Generator<RunEvent>, abortController: AbortController, log: Logger, resumeHandler: ResumeHandler, checkpointMgr: CheckpointManager, planManager: PlanManager);
+    runLoop(): AsyncGenerator<RunEvent>;
+    private hasRunningAgentTasks;
+    private waitAndInjectNotifications;
+    private injectOneTaskNotification;
+    private requestFinalResponse;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/query/iteration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/query/iteration/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAMvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKlE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EACX,cAAc,EACd,QAAQ,EAER,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,iCAAiC,EAAE,WAAW,CAAC;IACpE,SAAS,CAAC,EAAE,OAAO,8BAA8B,EAAE,SAAS,CAAC;IAC7D,aAAa,CAAC,EAAE,GAAG,CAAC,OAAO,6BAA6B,EAAE,MAAM,EAAE,OAAO,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;CAClH;AAED,qBAAa,qBAAqB;IACjC,OAAO,CAAC,GAAG,CAAmB;gBAG7B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,cAAc,EAC1B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,gBAAgB,EACvB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,EACvC,eAAe,EAAE,eAAe,EAChC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,iBAAiB,EAChC,WAAW,EAAE,WAAW;IAyBlB,OAAO,IAAI,cAAc,CAAC,QAAQ,CAAC;IAgR1C,OAAO,CAAC,oBAAoB;YAOb,0BAA0B;YAa1B,yBAAyB;YA2C1B,oBAAoB;CAmDlC"}