@gajae-code/coding-agent 0.10.1 → 0.11.0

package/dist/types/sdk/host/types.d.ts

@@ -0,0 +1,32 @@
+export type SdkFrame = Record<string, unknown>;
+/** Narrow common surface shared by control and query adapters. */
+export interface SessionSurface {
+    sessionId: string;
+}
+export interface SessionOperationSurface extends SessionSurface {
+    /** Query rows backed by this session's installed binding map. */
+    installedQueries?: ReadonlySet<string>;
+}
+/** Operations the neutral control dispatcher may require from a session. */
+export interface ControlSurface extends SessionSurface {
+    [key: string]: unknown;
+}
+export interface HostEndpointAdapters {
+    sessionId: string;
+    stateRoot: string;
+    token: string;
+    sendFrame: (connectionId: string, frame: SdkFrame) => void | Promise<void>;
+    onFrame: (handler: (connectionId: string, frame: SdkFrame) => void) => undefined | (() => void);
+}
+export interface BrokerIndexWriter {
+    register(input: {
+        sessionId: string;
+        stateRoot: string;
+        endpointGeneration: number;
+    }): void | Promise<void>;
+    unregister?(input: {
+        sessionId: string;
+        stateRoot: string;
+        endpointGeneration: number;
+    }): void | Promise<void>;
+}

package/dist/types/sdk/index.d.ts

@@ -0,0 +1,6 @@
+export * as bus from "./bus";
+export * from "./client";
+export * as host from "./host";
+export * as mcp from "./mcp";
+export type { Q10CurrentThinkingLevel, Q10Model, Q10SettableThinkingLevel, Q10ThinkingCapabilities, Q10ThinkingEffort, Q10ThinkingMode, } from "./models";
+export * from "./session";

package/dist/types/sdk/lifecycle-session.d.ts

@@ -0,0 +1,14 @@
+import type { AgentSession } from "../session/agent-session";
+import { type CreateAgentSessionOptions } from "./session";
+import { SdkStartupCapability, type SdkStartupFailure, SdkStartupRollbackTracker } from "./startup-capability";
+export type CreateLifecycleAgentSessionResult = {
+    session: AgentSession;
+    capability: SdkStartupCapability;
+    rollback: SdkStartupRollbackTracker;
+} | {
+    capability: SdkStartupCapability;
+    rollback: SdkStartupRollbackTracker;
+    failure: SdkStartupFailure;
+};
+/** Internal lifecycle-only session construction with an owner-bound SDK startup result. */
+export declare function createLifecycleAgentSession(options?: CreateAgentSessionOptions): Promise<CreateLifecycleAgentSessionResult>;

package/dist/types/sdk/mcp/index.d.ts

@@ -0,0 +1 @@
+export * from "./server";

package/dist/types/sdk/mcp/server.d.ts

@@ -0,0 +1,37 @@
+import { SdkClient } from "../client/client";
+type Arguments = Record<string, unknown>;
+type JsonRpcRequest = {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: unknown;
+};
+type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+};
+export interface SdkMcpServerOptions {
+    repo?: string;
+    agentDir?: string;
+    connect?: (url: string, token: string) => Promise<SdkClient>;
+}
+export declare const SDK_MCP_TOOL_NAMES: readonly ["gjc_session_control", "gjc_session_query", "gjc_session_global", "gjc_session_list"];
+/** Creates the model-facing MCP adapter using only SDK discovery records and v3 WebSockets. */
+export declare function createSdkMcpServer(options?: SdkMcpServerOptions): {
+    callTool: (name: string, args?: Arguments) => Promise<unknown>;
+    handleJsonRpc: (request: JsonRpcRequest) => Promise<JsonRpcResponse>;
+    handle: (request: JsonRpcRequest) => Promise<JsonRpcResponse>;
+    tools: Record<string, unknown>[];
+};
+/**
+ * Runs the SDK MCP server over stdio (newline-delimited JSON-RPC), the shipped
+ * `gjc mcp-serve sdk` entrypoint. Pure SDK client: session control/query flows
+ * through discovery records and v3 WebSockets only.
+ */
+export declare function runSdkMcpStdio(options?: SdkMcpServerOptions): Promise<void>;
+export {};

package/dist/types/sdk/models.d.ts

@@ -0,0 +1,44 @@
+import { ThinkingLevel } from "@gajae-code/agent-core";
+import { type Api, type Effort, type Model, type ThinkingControlMode } from "@gajae-code/ai";
+export type Q10ThinkingEffort = Effort;
+export type Q10SettableThinkingLevel = typeof ThinkingLevel.Off | Q10ThinkingEffort;
+export type Q10CurrentThinkingLevel = Q10SettableThinkingLevel | typeof ThinkingLevel.Inherit;
+export type Q10ThinkingMode = ThinkingControlMode;
+export interface Q10ThinkingCapabilities {
+    validLevels: readonly Q10SettableThinkingLevel[];
+    minLevel?: Q10ThinkingEffort;
+    maxLevel?: Q10ThinkingEffort;
+    mode?: Q10ThinkingMode;
+    defaultLevel?: Q10ThinkingEffort;
+    /** Fresh raw explicit descriptor copy; source order retained. */
+    levels?: readonly Q10ThinkingEffort[];
+}
+export interface Q10Model {
+    provider: string;
+    id: string;
+    name: string;
+    contextWindow: number;
+    maxTokens: number;
+    reasoning: boolean;
+    thinking: Q10ThinkingCapabilities;
+    current: boolean;
+    currentThinkingLevel?: Q10CurrentThinkingLevel;
+}
+export type Q10ThinkingMetadataReason = "missing_thinking" | "unknown_min_level" | "unknown_max_level" | "inverted_range" | "unknown_mode" | "empty_levels" | "unknown_level" | "level_out_of_range" | "lower_bound_mismatch" | "upper_bound_mismatch" | "supported_membership_mismatch" | "empty_supported_levels" | "unknown_default_level" | "default_not_supported";
+/** An intentionally safe error for malformed model thinking metadata. */
+export declare class Q10ThinkingMetadataError extends Error {
+    readonly reason: Q10ThinkingMetadataReason;
+    readonly code = "internal";
+    constructor(provider: string, id: string, reason: Q10ThinkingMetadataReason);
+}
+export interface Q10ModelProjectionInput {
+    models: readonly Model<Api>[];
+    currentModel?: Model<Api>;
+    currentThinkingLevel?: Q10CurrentThinkingLevel;
+    resolveSupportedEfforts?: (model: Model<Api>) => readonly Effort[];
+}
+/**
+ * Projects model registry entries into the Q10 public DTO without exposing
+ * transport, credentials, pricing, or other registry internals.
+ */
+export declare function projectQ10Models(input: Q10ModelProjectionInput): Q10Model[];

package/dist/types/sdk/protocol/adapter-validation.d.ts

@@ -0,0 +1,14 @@
+type Input = Record<string, unknown>;
+type SecretInputError = {
+    code: "secret_field_forbidden";
+    message: string;
+};
+/** Rejects secret-bearing config patches from model-facing adapter inputs. */
+export declare function validateAdapterSecretFields(operation: string, input: Input): SecretInputError | undefined;
+export type AdapterValidationError = {
+    code: "invalid_reload_component" | "invalid_input";
+    message: string;
+};
+/** Validates controls that adapters must reject before forwarding them to a host. */
+export declare function validateAdapterControl(operation: string, input: Input): AdapterValidationError | undefined;
+export {};

package/dist/types/sdk/protocol/operation-registry.d.ts

@@ -0,0 +1,24 @@
+export declare const ADAPTERS: readonly ["telegram", "discord", "slack", "mcp", "acp", "daemonCli"];
+export type Adapter = (typeof ADAPTERS)[number];
+export type AdapterDisposition = "native_alias" | "generic_safe" | "machine_only" | "provider_only" | "prohibited";
+export type OperationKind = "control" | "global" | "query" | "reverse";
+export type Idempotency = "idempotent" | "ordered" | "fast_lane";
+export type QueryContinuityClass = "stable_prefix" | "retained_revision" | "scalar_snapshot" | "content_addressed";
+export interface Operation {
+    id: string;
+    sdkId: string;
+    kind: OperationKind;
+    description: string;
+    idempotency: Idempotency;
+    errorCodes: string[];
+    revisionResource?: string;
+    continuityClass?: QueryContinuityClass;
+    adapterDispositions: Record<Adapter, AdapterDisposition>;
+    testIds: string[];
+}
+export declare function findOperation(kind: OperationKind, sdkId: string): Operation | undefined;
+export declare function adapterDispositionError(adapter: Adapter, kind: OperationKind, sdkId: string, modelFacing?: boolean): {
+    code: string;
+    message: string;
+} | undefined;
+export declare const OPERATIONS: readonly Operation[];

package/dist/types/{sdk.d.ts → sdk/session.d.ts}

@@ -1,30 +1,30 @@
-import { type AgentTelemetryConfig, type ThinkingLevel } from "@gajae-code/agent-core";
+import { type AgentTelemetryConfig, ThinkingLevel } from "@gajae-code/agent-core";
 import { type AuthCredentialSelector, type Model, type ProviderSessionState } from "@gajae-code/ai";
-import { createAppendOnlyContextManager, providerSupportsAppendOnlyAuto, resolveAppendOnlyMode } from "./append-only-mode";
-import { type Rule } from "./capability/rule";
-import { ModelRegistry } from "./config/model-registry";
-import { type ScopedModelSelection } from "./config/model-resolver";
-import { type PromptTemplate } from "./config/prompt-templates";
-import { Settings, type SkillsSettings } from "./config/settings";
-import type { BashRestrictionProfile } from "./tools/bash-allowed-prefixes";
-import "./discovery";
-import type { CustomCommandsLoadResult } from "./extensibility/custom-commands";
-import type { CustomTool } from "./extensibility/custom-tools/types";
-import { type ExtensionFactory, type ExtensionUIContext, type LoadExtensionsResult, type ToolDefinition } from "./extensibility/extensions";
-import { type ConstrainedPluginHook } from "./extensibility/gjc-plugins/constrained-hooks";
-import { type Skill, type SkillWarning } from "./extensibility/skills";
-import type { FileSlashCommand } from "./extensibility/slash-commands";
-import type { HindsightSessionState } from "./hindsight/state";
-import { type LocalProtocolOptions } from "./internal-urls";
-import { AgentRegistry } from "./registry/agent-registry";
-import { MCPManager } from "./runtime-mcp";
-import { AgentSession, type ForkContextSeed } from "./session/agent-session";
-import { AuthStorage } from "./session/auth-storage";
-import { SessionManager } from "./session/session-manager";
-import { type BuildSystemPromptResult } from "./system-prompt";
-import { BashTool, BUILTIN_TOOLS, createTools, EditTool, EvalTool, FindTool, HIDDEN_TOOLS, type LspStartupServerInfo, loadSshTool, ReadTool, ResolveTool, SearchTool, type Tool, type ToolSession, WebSearchTool, WriteTool } from "./tools";
-import { EventBus } from "./utils/event-bus";
-import { type WorkspaceTree } from "./workspace-tree";
+import { createAppendOnlyContextManager, providerSupportsAppendOnlyAuto, resolveAppendOnlyMode } from "../append-only-mode";
+import { type Rule } from "../capability/rule";
+import { ModelRegistry } from "../config/model-registry";
+import { type ScopedModelSelection } from "../config/model-resolver";
+import { type PromptTemplate } from "../config/prompt-templates";
+import { Settings, type SkillsSettings } from "../config/settings";
+import type { BashRestrictionProfile } from "../tools/bash-allowed-prefixes";
+import "../discovery";
+import type { CustomCommandsLoadResult } from "../extensibility/custom-commands";
+import type { CustomTool } from "../extensibility/custom-tools/types";
+import { type ExtensionFactory, type ExtensionUIContext, type LoadExtensionsResult, type ToolDefinition } from "../extensibility/extensions";
+import { type ConstrainedPluginHook } from "../extensibility/gjc-plugins/constrained-hooks";
+import { type Skill, type SkillWarning } from "../extensibility/skills";
+import type { FileSlashCommand } from "../extensibility/slash-commands";
+import type { HindsightSessionState } from "../hindsight/state";
+import { type LocalProtocolOptions } from "../internal-urls";
+import { AgentRegistry } from "../registry/agent-registry";
+import { MCPManager } from "../runtime-mcp";
+import { AgentSession, type ForkContextSeed } from "../session/agent-session";
+import { AuthStorage } from "../session/auth-storage";
+import { SessionManager } from "../session/session-manager";
+import { type BuildSystemPromptResult } from "../system-prompt";
+import { BashTool, BUILTIN_TOOLS, createTools, EditTool, EvalTool, FindTool, HIDDEN_TOOLS, type LspStartupServerInfo, loadSshTool, ReadTool, ResolveTool, SearchTool, type Tool, type ToolSession, WebSearchTool, WriteTool } from "../tools";
+import { EventBus } from "../utils/event-bus";
+import { type WorkspaceTree } from "../workspace-tree";
 export interface CreateAgentSessionOptions {
     /** Working directory for project-local discovery. Default: getProjectDir() */
     cwd?: string;
@@ -100,8 +100,12 @@ export interface CreateAgentSessionOptions {
     slashCommands?: FileSlashCommand[];
     /** @deprecated MCP runtime discovery is quarantined and ignored. */
     enableMCP?: boolean;
-    /** Existing MCP manager to reuse (skips discovery, propagates to toolSession). */
+    /** Existing MCP manager to reuse (skips discovery, propagates to toolSession).
+     * Mutually exclusive with mcpConfigPath. */
     mcpManager?: MCPManager;
+    /** Load MCP tools for a top-level session only from this caller-owned absolute config file path.
+     * Mutually exclusive with mcpManager. */
+    mcpConfigPath?: string;
     /** Enable LSP integration (tool, formatting, diagnostics, warmup). Default: true */
     enableLsp?: boolean;
     /** Skip Python kernel availability check and prelude warmup */
@@ -144,6 +148,8 @@ export interface CreateAgentSessionOptions {
     settings?: Settings;
     /** Whether UI is available (enables interactive tools like ask). Default: false */
     hasUI?: boolean;
+    /** Whether this host mode can own a notification session endpoint. Default: true. */
+    notificationHostModeSupported?: boolean;
     /**
      * Opt-in OpenTelemetry instrumentation forwarded to the underlying Agent.
      * Passing `{}` enables the loop's GenAI-semantic-convention spans. See
@@ -169,24 +175,24 @@ export interface CreateAgentSessionResult {
     extensionsResult: LoadExtensionsResult;
     /** Update tool UI context (interactive mode) */
     setToolUIContext: (uiContext: ExtensionUIContext, hasUI: boolean) => void;
-    /** MCP manager for server lifecycle management (undefined if MCP disabled) */
+    /** MCP manager for server lifecycle management (undefined if MCP disabled or an exact tools-only config is session-owned) */
     mcpManager?: MCPManager;
     /** Warning if session was restored with a different model than saved */
     modelFallbackMessage?: string;
-    /** LSP servers detected for startup; warmup may continue in the background */
+    /** LSP servers configured for lazy startup in interactive mode */
     lspServers?: LspStartupServerInfo[];
     /** Shared event bus for tool/extension communication */
     eventBus: EventBus;
 }
-export type { PromptTemplate } from "./config/prompt-templates";
-export { Settings, type SkillsSettings } from "./config/settings";
-export type { CustomCommand, CustomCommandFactory } from "./extensibility/custom-commands/types";
-export type { CustomTool, CustomToolFactory } from "./extensibility/custom-tools/types";
-export type * from "./extensibility/extensions";
-export type { Skill } from "./extensibility/skills";
-export type { FileSlashCommand } from "./extensibility/slash-commands";
-export type { Tool } from "./tools";
-export { buildDirectoryTree, buildWorkspaceTree, type DirectoryTree, type WorkspaceTree } from "./workspace-tree";
+export type { PromptTemplate } from "../config/prompt-templates";
+export { Settings, type SkillsSettings } from "../config/settings";
+export type { CustomCommand, CustomCommandFactory } from "../extensibility/custom-commands/types";
+export type { CustomTool, CustomToolFactory } from "../extensibility/custom-tools/types";
+export type * from "../extensibility/extensions";
+export type { Skill } from "../extensibility/skills";
+export type { FileSlashCommand } from "../extensibility/slash-commands";
+export type { Tool } from "../tools";
+export { buildDirectoryTree, buildWorkspaceTree, type DirectoryTree, type WorkspaceTree } from "../workspace-tree";
 export { BashTool, BUILTIN_TOOLS, createTools, EditTool, EvalTool, FindTool, HIDDEN_TOOLS, loadSshTool, ReadTool, ResolveTool, SearchTool, type ToolSession, WebSearchTool, WriteTool, };
 /**
  * Create an AuthStorage instance.

package/dist/types/sdk/startup-capability.d.ts

@@ -0,0 +1,50 @@
+export type SdkStartupPhase = "registration" | "startup";
+export type SdkStartupReason = "disabled" | "ineligible" | "factory_absent" | "runner_absent" | "pending" | "failed";
+export interface SdkStartupFailure {
+    phase: SdkStartupPhase;
+    reason: SdkStartupReason;
+    message: string;
+}
+export type SdkStartupResult = {
+    status: "started";
+} | {
+    status: "failed";
+    failure: SdkStartupFailure;
+};
+/** Internal symbols for lifecycle-only SDK startup construction and bus wiring. */
+export declare const lifecycleStartupCapabilityOption: unique symbol;
+export declare function attachLifecycleStartupCapability(api: object, capability: SdkStartupCapability): void;
+export declare function lifecycleStartupCapabilityForApi(api: object): SdkStartupCapability | undefined;
+export interface SdkStartupRollbackResult {
+    endpointGeneration: number | null;
+    fenced: boolean;
+    runtimeRemoved: boolean;
+    hostStopped: boolean;
+    brokerRegistrationReleased: boolean;
+}
+/** Internal lifecycle-only proof recorder. Fields become true only after their operation completes. */
+export declare class SdkStartupRollbackTracker {
+    #private;
+    get generation(): number | undefined;
+    get result(): SdkStartupRollbackResult;
+    recordGeneration(generation: number): void;
+    recordAbsent(): void;
+    recordStop(generation: number, result: Pick<SdkStartupRollbackResult, "runtimeRemoved" | "hostStopped" | "brokerRegistrationReleased">): void;
+}
+/** Redact untrusted startup errors before they cross the lifecycle boundary. */
+export declare function sanitizeSdkStartupMessage(value: unknown, knownSecrets?: Iterable<unknown>): string;
+/** Convert every lifecycle bootstrap outcome to the public, bounded failure shape. */
+export declare function normalizeSdkStartupFailure(phase: SdkStartupPhase, reason: SdkStartupReason, error?: unknown, knownSecrets?: Iterable<unknown>): SdkStartupFailure;
+/** Session-owned, exactly-once lifecycle bootstrap completion. */
+export declare class SdkStartupCapability {
+    #private;
+    readonly rollback?: SdkStartupRollbackTracker | undefined;
+    get cancelled(): boolean;
+    cancel(): void;
+    constructor(rollback?: SdkStartupRollbackTracker | undefined);
+    normalizeFailure(phase: SdkStartupPhase, reason: SdkStartupReason, error?: unknown): SdkStartupFailure;
+    get result(): SdkStartupResult | undefined;
+    get promise(): Promise<SdkStartupResult>;
+    settleStarted(): SdkStartupResult;
+    settleFailure(failure: SdkStartupFailure): SdkStartupResult;
+}