stitchkit 0.54.0 → 0.56.0

package/dist/tools/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGlC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,EACnC,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAwET"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,OAAO,EAAE,MAAM,IAAI,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,EACnC,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAwET"}

package/dist/tools/async-operation.d.ts

@@ -0,0 +1,360 @@
+import { type ZodObject, type ZodType, z } from 'zod';
+import type { ContractDef, EndpointDef, EndpointToolAnnotations, HttpMethod } from '../contract';
+import type { Handlers } from '../server/types';
+import { type RuntimeToolDefinition, type RuntimeToolDefinitionWithOutput, type RuntimeToolHandlerContext, type RuntimeToolTransport } from './runtime-tool';
+export declare const AsyncOperationCancelResultSchema: z.ZodDiscriminatedUnion<[ZodObject<{
+    outcome: z.ZodLiteral<"accepted">;
+}, z.core.$strip>, ZodObject<{
+    outcome: z.ZodLiteral<"already_terminal">;
+}, z.core.$strip>, ZodObject<{
+    outcome: z.ZodLiteral<"rejected">;
+    reason: z.ZodString;
+}, z.core.$strip>], "outcome">;
+export type AsyncOperationCancelResult = z.infer<typeof AsyncOperationCancelResultSchema>;
+export type AsyncOperationCapability = 'start' | 'status' | 'wait' | 'cancel' | 'result' | 'artifacts';
+export declare function createAsyncOperationSnapshotSchema<TProgress extends ZodType | undefined = undefined, TFailure extends ZodType = ZodType>(config: {
+    progress?: TProgress;
+    failure: TFailure;
+}): z.ZodDiscriminatedUnion<[ZodObject<{
+    progress: z.ZodOptional<ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    phase: z.ZodLiteral<"pending">;
+} | {
+    progress?: undefined;
+    phase: z.ZodLiteral<"pending">;
+}, z.core.$strip>, ZodObject<{
+    progress: z.ZodOptional<ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    phase: z.ZodLiteral<"running">;
+} | {
+    progress?: undefined;
+    phase: z.ZodLiteral<"running">;
+}, z.core.$strip>, ZodObject<{
+    progress: z.ZodOptional<ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    phase: z.ZodLiteral<"succeeded">;
+} | {
+    progress?: undefined;
+    phase: z.ZodLiteral<"succeeded">;
+}, z.core.$strip>, ZodObject<{
+    progress: z.ZodOptional<ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    phase: z.ZodLiteral<"failed">;
+    failure: TFailure;
+} | {
+    progress?: undefined;
+    phase: z.ZodLiteral<"failed">;
+    failure: TFailure;
+}, z.core.$strip>, ZodObject<{
+    progress: z.ZodOptional<ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    phase: z.ZodLiteral<"cancelled">;
+} | {
+    progress?: undefined;
+    phase: z.ZodLiteral<"cancelled">;
+}, z.core.$strip>], "phase">;
+export interface AsyncOperationIdentity {
+    serviceName: string;
+    action: string;
+    scope?: string;
+    meta?: Record<string, unknown>;
+}
+export interface AsyncOperationCancelCapability<TId extends ZodObject, TState extends ZodType> {
+    handler: (state: z.output<TState>, context: RuntimeToolHandlerContext<TId>) => z.output<typeof AsyncOperationCancelResultSchema> | Promise<z.output<typeof AsyncOperationCancelResultSchema>>;
+}
+export interface AsyncOperationOutputCapability<TId extends ZodObject, TState extends ZodType, TOutput extends ZodType> {
+    output: TOutput;
+    handler: (state: z.output<TState>, context: RuntimeToolHandlerContext<TId>) => z.output<TOutput> | Promise<z.output<TOutput>>;
+}
+export interface RuntimeAsyncOperationConfig<TStartInput extends ZodObject, TId extends ZodObject, TState extends ZodType, TSnapshot extends ZodType, TCancel extends AsyncOperationCancelCapability<TId, TState> = never, TResult extends AsyncOperationOutputCapability<TId, TState, ZodType> = never, TArtifacts extends AsyncOperationOutputCapability<TId, TState, ZodType> = never> {
+    mode: 'runtime-only';
+    /** Provider-safe prefix used for the generated capability names. */
+    name: string;
+    description: string;
+    identity: AsyncOperationIdentity;
+    startInput: TStartInput;
+    id: TId;
+    state: TState;
+    snapshot: TSnapshot;
+    start: (input: z.output<TStartInput>, context: RuntimeToolHandlerContext<TStartInput>) => z.output<TId> | Promise<z.output<TId>>;
+    /** Mandatory resource authorization, repeated before every follow-up callback. */
+    authorize: (id: z.output<TId>, capability: Exclude<AsyncOperationCapability, 'start'>, context: RuntimeToolHandlerContext<TId>) => void | Promise<void>;
+    inspect: (id: z.output<TId>, context: RuntimeToolHandlerContext<TId>) => z.output<TState> | Promise<z.output<TState>>;
+    classify: (state: z.output<TState>, context: RuntimeToolHandlerContext<TId>) => z.output<TSnapshot> | Promise<z.output<TSnapshot>>;
+    cancel?: TCancel;
+    result?: TResult;
+    artifacts?: TArtifacts;
+    names?: Partial<Record<AsyncOperationCapability, string>>;
+    descriptions?: Partial<Record<AsyncOperationCapability, string>>;
+    scopes?: Partial<Record<AsyncOperationCapability, string>>;
+    annotations?: Partial<Record<AsyncOperationCapability, EndpointToolAnnotations>>;
+    transports?: Partial<Record<AsyncOperationCapability, readonly RuntimeToolTransport[]>>;
+    backoff?: number[];
+    defaultTimeout?: number;
+    timeoutFromId?: (id: z.output<TId>) => number | undefined;
+}
+export type AsyncOperationStartDefinition<TInput extends ZodObject, TId extends ZodObject> = RuntimeToolDefinitionWithOutput<TInput, TId>;
+export type AsyncOperationFollowDefinition<TId extends ZodObject, TOutput extends ZodType> = RuntimeToolDefinitionWithOutput<TId, TOutput>;
+export type RuntimeAsyncOperation<TStartInput extends ZodObject, TId extends ZodObject, TSnapshot extends ZodType, TCancel, TResult, TArtifacts> = {
+    start: AsyncOperationStartDefinition<TStartInput, TId>;
+    status: AsyncOperationFollowDefinition<TId, TSnapshot>;
+    wait: AsyncOperationFollowDefinition<TId, TSnapshot>;
+    runtimeTools: readonly RuntimeToolDefinition[];
+    schemas: {
+        id: TId;
+        snapshot: TSnapshot;
+        cancelResult: typeof AsyncOperationCancelResultSchema;
+    };
+} & ([TCancel] extends [never] ? object : {
+    cancel: AsyncOperationFollowDefinition<TId, typeof AsyncOperationCancelResultSchema>;
+}) & ([TResult] extends [never] ? object : TResult extends {
+    output: infer TOutput extends ZodType;
+} ? {
+    result: AsyncOperationFollowDefinition<TId, TOutput>;
+} : object) & ([TArtifacts] extends [never] ? object : TArtifacts extends {
+    output: infer TOutput extends ZodType;
+} ? {
+    artifacts: AsyncOperationFollowDefinition<TId, TOutput>;
+} : object);
+/** Define a pathless async-operation surface. It never creates an HTTP route. */
+export declare function defineAsyncOperation<TStartInput extends ZodObject, TId extends ZodObject, TState extends ZodType, TSnapshot extends ZodType, TCancel extends AsyncOperationCancelCapability<TId, TState> = never, TResult extends AsyncOperationOutputCapability<TId, TState, ZodType> = never, TArtifacts extends AsyncOperationOutputCapability<TId, TState, ZodType> = never>(config: RuntimeAsyncOperationConfig<TStartInput, TId, TState, TSnapshot, TCancel, TResult, TArtifacts>): RuntimeAsyncOperation<TStartInput, TId, TSnapshot, TCancel, TResult, TArtifacts>;
+export type ContractAsyncOperationKeys<TEndpoints extends Record<string, EndpointDef>> = keyof TEndpoints & string;
+type EndpointInputSchema<TEndpoint> = TEndpoint extends {
+    input: infer TSchema extends ZodType;
+} ? TSchema : never;
+type EndpointOutputSchema<TEndpoint> = TEndpoint extends {
+    output: infer TSchema extends ZodType;
+} ? TSchema : never;
+type TypesEqual<TLeft, TRight> = [TLeft] extends [TRight] ? [TRight] extends [TLeft] ? true : false : false;
+type StableSchema<TSchema extends ZodType> = TypesEqual<z.input<TSchema>, z.output<TSchema>> extends true ? TSchema : never;
+type SchemasEquivalent<TLeft extends ZodType, TRight extends ZodType> = TypesEqual<z.input<TLeft>, z.input<TRight>> extends true ? TypesEqual<z.output<TLeft>, z.output<TRight>> : false;
+type CanonicalAsyncOperationEndpoint<TMethod extends Exclude<HttpMethod, 'HEAD'>, TPath extends string, TInput extends ZodType, TOutput extends ZodType, TScopeField extends object> = {
+    method: TMethod;
+    path: TPath;
+    desc: string;
+    input: TInput;
+    output: TOutput;
+} & TScopeField;
+type CapabilityScopeField<TScopes, TCapability extends AsyncOperationCapability> = TScopes extends Partial<Record<AsyncOperationCapability, string>> ? TCapability extends keyof TScopes ? {
+    scope: Extract<TScopes[TCapability], string>;
+} : Record<never, never> : Record<never, never>;
+type CanonicalAsyncOperationEndpoints<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TStartOutput extends ZodType, TCancel, TResult, TArtifacts, TScopes> = {
+    start: CanonicalAsyncOperationEndpoint<'POST', '/', TStartInput, TStartOutput, CapabilityScopeField<TScopes, 'start'>>;
+    status: CanonicalAsyncOperationEndpoint<'POST', '/status', TId, TSnapshot, CapabilityScopeField<TScopes, 'status'>>;
+    wait: CanonicalAsyncOperationEndpoint<'POST', '/wait', TId, TSnapshot, CapabilityScopeField<TScopes, 'wait'>>;
+} & ([TCancel] extends [true] ? {
+    cancel: CanonicalAsyncOperationEndpoint<'POST', '/cancel', TId, typeof AsyncOperationCancelResultSchema, CapabilityScopeField<TScopes, 'cancel'>>;
+} : object) & ([TResult] extends [ZodType] ? {
+    result: CanonicalAsyncOperationEndpoint<'POST', '/result', TId, TResult, CapabilityScopeField<TScopes, 'result'>>;
+} : object) & ([TArtifacts] extends [ZodType] ? {
+    artifacts: CanonicalAsyncOperationEndpoint<'POST', '/artifacts', TId, TArtifacts, CapabilityScopeField<TScopes, 'artifacts'>>;
+} : object);
+type CanonicalAsyncOperationCapabilities<TCancel, TResult, TArtifacts> = {
+    start: 'start';
+    status: 'status';
+    wait: 'wait';
+} & ([TCancel] extends [true] ? {
+    cancel: 'cancel';
+} : object) & ([TResult] extends [ZodType] ? {
+    result: 'result';
+} : object) & ([TArtifacts] extends [ZodType] ? {
+    artifacts: 'artifacts';
+} : object);
+type CanonicalAsyncOperationInputFor<TId extends ZodType, TCancel, TResult, TArtifacts> = {
+    status: (id: z.output<TId>) => z.output<TId>;
+    wait: (id: z.output<TId>) => z.output<TId>;
+} & ([TCancel] extends [true] ? {
+    cancel: (id: z.output<TId>) => z.output<TId>;
+} : object) & ([TResult] extends [ZodType] ? {
+    result: (id: z.output<TId>) => z.output<TId>;
+} : object) & ([TArtifacts] extends [ZodType] ? {
+    artifacts: (id: z.output<TId>) => z.output<TId>;
+} : object);
+type CanonicalAsyncOperationSchemas<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TStartOutput extends ZodType, TCancel, TResult, TArtifacts> = {
+    startInput: TStartInput;
+    startOutput: TStartOutput;
+    id: TId;
+    snapshot: TSnapshot;
+    cancelResult: typeof AsyncOperationCancelResultSchema;
+} & ([TCancel] extends [true] ? {
+    cancel: typeof AsyncOperationCancelResultSchema;
+} : object) & ([TResult] extends [ZodType] ? {
+    result: TResult;
+} : object) & ([TArtifacts] extends [ZodType] ? {
+    artifacts: TArtifacts;
+} : object);
+type EndpointRecord<TEndpoints> = TEndpoints extends Record<string, EndpointDef> ? TEndpoints : never;
+interface AsyncOperationContractBaseConfig<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TCancel extends true | undefined = undefined, TResult extends ZodType | undefined = undefined, TArtifacts extends ZodType | undefined = undefined, TScope extends string = 'public', TScopes extends Partial<Record<AsyncOperationCapability, string>> = Record<never, never>> {
+    prefix: string;
+    scope?: TScope;
+    description: string;
+    startInput: TStartInput;
+    /** Canonical follow-up inputs use the ID value directly, so input/output must be stable. */
+    id: StableSchema<TId>;
+    snapshot: TSnapshot;
+    cancel?: TCancel;
+    result?: TResult;
+    artifacts?: TArtifacts;
+    descriptions?: Partial<Record<AsyncOperationCapability, string>>;
+    scopes?: TScopes;
+}
+export type AsyncOperationContractConfig<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TCancel extends true | undefined = undefined, TResult extends ZodType | undefined = undefined, TArtifacts extends ZodType | undefined = undefined, TScope extends string = 'public', TScopes extends Partial<Record<AsyncOperationCapability, string>> = Record<never, never>> = AsyncOperationContractBaseConfig<TStartInput, TId, TSnapshot, TCancel, TResult, TArtifacts, TScope, TScopes> & {
+    startOutput?: never;
+    idFromStart?: never;
+};
+export type AsyncOperationContractWithStartOutputConfig<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TStartOutput extends ZodType, TCancel extends true | undefined = undefined, TResult extends ZodType | undefined = undefined, TArtifacts extends ZodType | undefined = undefined, TScope extends string = 'public', TScopes extends Partial<Record<AsyncOperationCapability, string>> = Record<never, never>> = AsyncOperationContractBaseConfig<TStartInput, TId, TSnapshot, TCancel, TResult, TArtifacts, TScope, TScopes> & {
+    startOutput: TStartOutput;
+    idFromStart: (output: z.output<TStartOutput>) => z.input<TId>;
+};
+export interface DefinedAsyncOperationContract<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TStartOutput extends ZodType, TCancel extends true | undefined, TResult extends ZodType | undefined, TArtifacts extends ZodType | undefined, TScope extends string = 'public', TScopes extends Partial<Record<AsyncOperationCapability, string>> = Record<never, never>> {
+    contract: ContractDef<EndpointRecord<CanonicalAsyncOperationEndpoints<TStartInput, TId, TSnapshot, TStartOutput, TCancel, TResult, TArtifacts, TScopes>>, TScope>;
+    capabilities: CanonicalAsyncOperationCapabilities<TCancel, TResult, TArtifacts>;
+    schemas: CanonicalAsyncOperationSchemas<TStartInput, TId, TSnapshot, TStartOutput, TCancel, TResult, TArtifacts>;
+    adapters: {
+        idFromStart: (output: z.output<TStartOutput>) => z.output<TId>;
+        inputFor: CanonicalAsyncOperationInputFor<TId, TCancel, TResult, TArtifacts>;
+    };
+}
+/** Define the canonical HTTP contract shape for an async operation. */
+export declare function defineAsyncOperationContract<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TCancel extends true | undefined = undefined, TResult extends ZodType | undefined = undefined, TArtifacts extends ZodType | undefined = undefined, TScope extends string = 'public', const TScopes extends Partial<Record<AsyncOperationCapability, string>> = Record<never, never>>(config: AsyncOperationContractConfig<TStartInput, TId, TSnapshot, TCancel, TResult, TArtifacts, TScope, TScopes>): DefinedAsyncOperationContract<TStartInput, TId, TSnapshot, TId, TCancel, TResult, TArtifacts, TScope, TScopes>;
+export declare function defineAsyncOperationContract<TStartInput extends ZodType, TId extends ZodType, TSnapshot extends ZodType, TStartOutput extends ZodType, TCancel extends true | undefined = undefined, TResult extends ZodType | undefined = undefined, TArtifacts extends ZodType | undefined = undefined, TScope extends string = 'public', const TScopes extends Partial<Record<AsyncOperationCapability, string>> = Record<never, never>>(config: AsyncOperationContractWithStartOutputConfig<TStartInput, TId, TSnapshot, TStartOutput, TCancel, TResult, TArtifacts, TScope, TScopes>): DefinedAsyncOperationContract<TStartInput, TId, TSnapshot, TStartOutput, TCancel, TResult, TArtifacts, TScope, TScopes>;
+export type AdaptedContractAsyncOperationStartKey<TEndpoints extends Record<string, EndpointDef>> = {
+    [TKey in keyof TEndpoints]: EndpointOutputSchema<TEndpoints[TKey]> extends never ? never : TKey;
+}[keyof TEndpoints] & string;
+export type ContractAsyncOperationStartKey<TEndpoints extends Record<string, EndpointDef>> = {
+    [TKey in AdaptedContractAsyncOperationStartKey<TEndpoints>]: EndpointOutputSchema<TEndpoints[TKey]> extends infer TOutput extends ZodType ? StableSchema<TOutput> extends never ? never : TKey : never;
+}[AdaptedContractAsyncOperationStartKey<TEndpoints>] & string;
+export type AdaptedContractAsyncOperationFollowKey<TEndpoints extends Record<string, EndpointDef>> = {
+    [TKey in keyof TEndpoints]: EndpointInputSchema<TEndpoints[TKey]> extends never ? never : EndpointOutputSchema<TEndpoints[TKey]> extends never ? never : TKey;
+}[keyof TEndpoints] & string;
+export type AdaptedContractAsyncOperationWaitKey<TEndpoints extends Record<string, EndpointDef>, TStatus extends AdaptedContractAsyncOperationFollowKey<TEndpoints>> = {
+    [TKey in AdaptedContractAsyncOperationFollowKey<TEndpoints>]: EndpointOutputSchema<TEndpoints[TKey]> extends infer TOutput extends ZodType ? EndpointOutputSchema<TEndpoints[TStatus]> extends infer TSnapshot extends ZodType ? SchemasEquivalent<TOutput, TSnapshot> extends true ? TKey : never : never : never;
+}[AdaptedContractAsyncOperationFollowKey<TEndpoints>] & string;
+export type ContractAsyncOperationFollowKey<TEndpoints extends Record<string, EndpointDef>, TStart extends ContractAsyncOperationStartKey<TEndpoints>> = {
+    [TKey in keyof TEndpoints]: EndpointInputSchema<TEndpoints[TKey]> extends infer TInput extends ZodType ? EndpointOutputSchema<TEndpoints[TStart]> extends infer TId extends ZodType ? SchemasEquivalent<TInput, TId> extends true ? TKey : never : never : never;
+}[keyof TEndpoints] & string;
+export type ContractAsyncOperationWaitKey<TEndpoints extends Record<string, EndpointDef>, TStart extends ContractAsyncOperationStartKey<TEndpoints>, TStatus extends ContractAsyncOperationFollowKey<TEndpoints, TStart>> = {
+    [TKey in keyof TEndpoints]: TKey extends ContractAsyncOperationFollowKey<TEndpoints, TStart> ? EndpointOutputSchema<TEndpoints[TKey]> extends infer TOutput extends ZodType ? EndpointOutputSchema<TEndpoints[TStatus]> extends infer TSnapshot extends ZodType ? SchemasEquivalent<TOutput, TSnapshot> extends true ? TKey : never : never : never : never;
+}[keyof TEndpoints] & string;
+export interface ContractAsyncOperationConfig<TEndpoints extends Record<string, EndpointDef>, TScope extends string, TStart extends ContractAsyncOperationStartKey<TEndpoints> = ContractAsyncOperationStartKey<TEndpoints>, TStatus extends ContractAsyncOperationFollowKey<TEndpoints, TStart> = ContractAsyncOperationFollowKey<TEndpoints, TStart>> {
+    mode: 'contract-backed';
+    binding?: 'direct';
+    contract: ContractDef<TEndpoints, TScope>;
+    capabilities: {
+        start: TStart;
+        status: ContractAsyncOperationFollowKey<TEndpoints, NoInfer<TStart>> & TStatus;
+        wait: ContractAsyncOperationWaitKey<TEndpoints, NoInfer<TStart>, NoInfer<TStatus>>;
+        cancel?: ContractAsyncOperationFollowKey<TEndpoints, NoInfer<TStart>>;
+        result?: ContractAsyncOperationFollowKey<TEndpoints, NoInfer<TStart>>;
+        artifacts?: ContractAsyncOperationFollowKey<TEndpoints, NoInfer<TStart>>;
+    };
+    handlers: Handlers<NoInfer<TEndpoints>>;
+}
+export interface AdaptedContractAsyncOperationConfig<TEndpoints extends Record<string, EndpointDef>, TScope extends string, TId extends ZodType, TStart extends AdaptedContractAsyncOperationStartKey<TEndpoints>, TStatus extends AdaptedContractAsyncOperationFollowKey<TEndpoints>, TWait extends AdaptedContractAsyncOperationWaitKey<TEndpoints, TStatus>, TCancel extends AdaptedContractAsyncOperationFollowKey<TEndpoints> | undefined = undefined, TResult extends AdaptedContractAsyncOperationFollowKey<TEndpoints> | undefined = undefined, TArtifacts extends AdaptedContractAsyncOperationFollowKey<TEndpoints> | undefined = undefined> {
+    mode: 'contract-backed';
+    binding: 'adapted';
+    contract: ContractDef<TEndpoints, TScope>;
+    id: TId;
+    capabilities: {
+        start: TStart;
+        status: TStatus;
+        wait: TWait;
+        cancel?: TCancel;
+        result?: TResult;
+        artifacts?: TArtifacts;
+    };
+    adapters: {
+        idFromStart: (output: z.output<EndpointOutputSchema<TEndpoints[NoInfer<TStart>]>>) => NoInfer<z.input<TId>>;
+        inputFor: {
+            status: (id: z.output<NoInfer<TId>>) => z.input<EndpointInputSchema<TEndpoints[NoInfer<TStatus>]>>;
+            wait: (id: z.output<NoInfer<TId>>) => z.input<EndpointInputSchema<TEndpoints[NoInfer<TWait>]>>;
+        } & ([TCancel] extends [string] ? {
+            cancel: (id: z.output<NoInfer<TId>>) => z.input<EndpointInputSchema<TEndpoints[NoInfer<TCancel> & keyof TEndpoints]>>;
+        } : object) & ([TResult] extends [string] ? {
+            result: (id: z.output<NoInfer<TId>>) => z.input<EndpointInputSchema<TEndpoints[NoInfer<TResult> & keyof TEndpoints]>>;
+        } : object) & ([TArtifacts] extends [string] ? {
+            artifacts: (id: z.output<NoInfer<TId>>) => z.input<EndpointInputSchema<TEndpoints[NoInfer<TArtifacts> & keyof TEndpoints]>>;
+        } : object);
+    };
+    handlers: Handlers<NoInfer<TEndpoints>>;
+}
+export interface BoundAdaptedContractAsyncOperation<TEndpoints extends Record<string, EndpointDef>, TScope extends string, TId extends ZodType, TStart extends AdaptedContractAsyncOperationStartKey<TEndpoints>, TStatus extends AdaptedContractAsyncOperationFollowKey<TEndpoints>, TWait extends AdaptedContractAsyncOperationWaitKey<TEndpoints, TStatus>, TCancel extends AdaptedContractAsyncOperationFollowKey<TEndpoints> | undefined, TResult extends AdaptedContractAsyncOperationFollowKey<TEndpoints> | undefined, TArtifacts extends AdaptedContractAsyncOperationFollowKey<TEndpoints> | undefined> {
+    contract: ContractDef<TEndpoints, TScope>;
+    handlers: Handlers<TEndpoints>;
+    capabilities: {
+        start: TStart;
+        status: TStatus;
+        wait: TWait;
+    } & ([TCancel] extends [string] ? {
+        cancel: TCancel;
+    } : object) & ([TResult] extends [string] ? {
+        result: TResult;
+    } : object) & ([TArtifacts] extends [string] ? {
+        artifacts: TArtifacts;
+    } : object);
+    schemas: {
+        id: TId;
+        snapshot: EndpointOutputSchema<TEndpoints[TStatus]>;
+    };
+    adapters: {
+        idFromStart: (output: z.output<EndpointOutputSchema<TEndpoints[TStart]>>) => z.output<TId>;
+        inputFor: {
+            status: (id: z.output<TId>) => z.output<EndpointInputSchema<TEndpoints[TStatus]>>;
+            wait: (id: z.output<TId>) => z.output<EndpointInputSchema<TEndpoints[TWait]>>;
+        } & ([TCancel] extends [string] ? {
+            cancel: (id: z.output<TId>) => z.output<EndpointInputSchema<TEndpoints[TCancel & keyof TEndpoints]>>;
+        } : object) & ([TResult] extends [string] ? {
+            result: (id: z.output<TId>) => z.output<EndpointInputSchema<TEndpoints[TResult & keyof TEndpoints]>>;
+        } : object) & ([TArtifacts] extends [string] ? {
+            artifacts: (id: z.output<TId>) => z.output<EndpointInputSchema<TEndpoints[TArtifacts & keyof TEndpoints]>>;
+        } : object);
+    };
+}
+type DirectContractAsyncOperationCapabilities<TEndpoints extends Record<string, EndpointDef>> = {
+    start: ContractAsyncOperationStartKey<TEndpoints>;
+    status: ContractAsyncOperationKeys<TEndpoints>;
+    wait: ContractAsyncOperationKeys<TEndpoints>;
+    cancel?: ContractAsyncOperationKeys<TEndpoints>;
+    result?: ContractAsyncOperationKeys<TEndpoints>;
+    artifacts?: ContractAsyncOperationKeys<TEndpoints>;
+};
+export type ContractAsyncOperationInputAdapters<TEndpoints extends Record<string, EndpointDef>, TCapabilities extends DirectContractAsyncOperationCapabilities<TEndpoints>> = {
+    status: (id: z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>) => z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>;
+    wait: (id: z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>) => z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>;
+} & (TCapabilities['cancel'] extends string ? {
+    cancel: (id: z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>) => z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>;
+} : Record<never, never>) & (TCapabilities['result'] extends string ? {
+    result: (id: z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>) => z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>;
+} : Record<never, never>) & (TCapabilities['artifacts'] extends string ? {
+    artifacts: (id: z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>) => z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>;
+} : Record<never, never>);
+type ValidDirectFollowCapability<TEndpoints extends Record<string, EndpointDef>, TCapabilities extends DirectContractAsyncOperationCapabilities<TEndpoints>, TCapability extends 'status' | 'cancel' | 'result' | 'artifacts'> = TCapabilities[TCapability] extends ContractAsyncOperationFollowKey<TEndpoints, TCapabilities['start']> ? TCapabilities[TCapability] : never;
+type ValidDirectContractAsyncOperationCapabilities<TEndpoints extends Record<string, EndpointDef>, TCapabilities extends DirectContractAsyncOperationCapabilities<TEndpoints>> = TCapabilities & {
+    status: ValidDirectFollowCapability<TEndpoints, TCapabilities, 'status'>;
+    wait: TCapabilities['wait'] extends ContractAsyncOperationWaitKey<TEndpoints, TCapabilities['start'], ValidDirectFollowCapability<TEndpoints, TCapabilities, 'status'>> ? TCapabilities['wait'] : never;
+    cancel?: ValidDirectFollowCapability<TEndpoints, TCapabilities, 'cancel'>;
+    result?: ValidDirectFollowCapability<TEndpoints, TCapabilities, 'result'>;
+    artifacts?: ValidDirectFollowCapability<TEndpoints, TCapabilities, 'artifacts'>;
+};
+type DirectContractAsyncOperationConstraint<TEndpoints extends Record<string, EndpointDef>, TCapabilities extends DirectContractAsyncOperationCapabilities<TEndpoints>> = TCapabilities extends ValidDirectContractAsyncOperationCapabilities<TEndpoints, TCapabilities> ? object : never;
+type ContractEndpointsOf<TContract extends ContractDef> = TContract['endpoints'];
+type ContractScopeOf<TContract extends ContractDef> = TContract extends ContractDef<Record<string, EndpointDef>, infer TScope> ? TScope : never;
+/**
+ * Bind a dedicated contract's already-declared methods as one async operation.
+ * The returned handlers go straight to `implement`; no schema or HTTP route is copied.
+ */
+export declare function bindContractAsyncOperation<const TContract extends ContractDef, TId extends ZodType, const TStart extends AdaptedContractAsyncOperationStartKey<ContractEndpointsOf<TContract>>, const TStatus extends AdaptedContractAsyncOperationFollowKey<ContractEndpointsOf<TContract>>, const TWait extends AdaptedContractAsyncOperationWaitKey<ContractEndpointsOf<TContract>, TStatus>, const TCancel extends AdaptedContractAsyncOperationFollowKey<ContractEndpointsOf<TContract>> | undefined = undefined, const TResult extends AdaptedContractAsyncOperationFollowKey<ContractEndpointsOf<TContract>> | undefined = undefined, const TArtifacts extends AdaptedContractAsyncOperationFollowKey<ContractEndpointsOf<TContract>> | undefined = undefined>(config: Omit<AdaptedContractAsyncOperationConfig<ContractEndpointsOf<TContract>, ContractScopeOf<TContract>, TId, TStart, TStatus, TWait, TCancel, TResult, TArtifacts>, 'contract'> & {
+    contract: TContract;
+}): BoundAdaptedContractAsyncOperation<ContractEndpointsOf<TContract>, ContractScopeOf<TContract>, TId, TStart, TStatus, TWait, TCancel, TResult, TArtifacts>;
+export declare function bindContractAsyncOperation<TEndpoints extends Record<string, EndpointDef>, TScope extends string, const TCapabilities extends DirectContractAsyncOperationCapabilities<TEndpoints>>(config: Omit<ContractAsyncOperationConfig<TEndpoints, TScope>, 'capabilities'> & {
+    capabilities: TCapabilities;
+} & DirectContractAsyncOperationConstraint<TEndpoints, TCapabilities>): {
+    contract: ContractDef<TEndpoints, TScope>;
+    handlers: Handlers<TEndpoints>;
+    capabilities: TCapabilities;
+    schemas: {
+        id: EndpointOutputSchema<TEndpoints[TCapabilities['start']]>;
+        snapshot: EndpointOutputSchema<TEndpoints[TCapabilities['status']]>;
+    };
+    adapters: {
+        idFromStart: (output: z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>) => z.output<EndpointOutputSchema<TEndpoints[TCapabilities['start']]>>;
+        inputFor: ContractAsyncOperationInputAdapters<TEndpoints, TCapabilities>;
+    };
+};
+export {};
+//# sourceMappingURL=async-operation.d.ts.map

package/dist/tools/async-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-operation.d.ts","sourceRoot":"","sources":["../../src/tools/async-operation.ts"],"names":[],"mappings":"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"}

package/dist/tools/cli-args.d.ts

@@ -20,7 +20,7 @@
 import { z } from 'zod';
 /** CLI-behaviour flags, parsed out of argv before the tool arguments. */
 export interface CliRunOptions {
-    /** `--json` — emit raw JSON on stdout for piping. */
+    /** `--json` — emit compact success/error JSON records for scripts. */
     json: boolean;
     /** `--wait` — block-poll an async result to a terminal state. */
     wait: boolean;

package/dist/tools/cli-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../src/tools/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,KAAK,SAAS,GACV,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ,UAAU,SAAS;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAOD,eAAO,MAAM,oBAAoB,aAA+C,CAAC;AAEjF,qBAAa,gBAAiB,SAAQ,KAAK;IAChC,IAAI,SAAsB;CACpC;AAuED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAI1F;AA8FD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,EAC7B,MAAM,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACvE,aAAa,CA+Kf"}
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../src/tools/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,IAAI,EAAE,OAAO,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,KAAK,SAAS,GACV,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ,UAAU,SAAS;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAOD,eAAO,MAAM,oBAAoB,aAA+C,CAAC;AAEjF,qBAAa,gBAAiB,SAAQ,KAAK;IAChC,IAAI,SAAsB;CACpC;AAuED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAI1F;AA8FD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,EAC7B,MAAM,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACvE,aAAa,CA+Kf"}

package/dist/tools/cli-format.d.ts

@@ -4,7 +4,7 @@
  * Output is JSON — the CLI's audience is agents (Skills via Bash), scripts and
  * `| jq`, for which structured JSON is the right shape, not a hand-formatted
  * table. The default is pretty-printed (indented, the same shape an MCP tool
- * returns); `--json` switches to a compact single line for piping.
+ * returns); `--json` switches success and error records to one compact line.
  *
  * stdout is reserved for that result; an error goes to stderr as the same
  * model-facing `{ error, details, _hint }` object the MCP / agent transports
@@ -24,7 +24,7 @@ export interface CliWriters {
     stderr: (text: string) => void;
 }
 export interface EmitOptions {
-    /** Compact single-line JSON (for `| jq` / scripts); otherwise pretty-printed. */
+    /** Compact single-line success/error JSON; otherwise pretty-printed. */
     json: boolean;
     toolName: string;
     errorHint?: ErrorHintFn;

package/dist/tools/cli-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-format.d.ts","sourceRoot":"","sources":["../../src/tools/cli-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGzD,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAUhC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,WAAW,GAChB,MAAM,CAeR"}
+{"version":3,"file":"cli-format.d.ts","sourceRoot":"","sources":["../../src/tools/cli-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGzD,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAWhC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,WAAW,GAChB,MAAM,CAgBR"}

package/dist/tools/cli-wait.d.ts

@@ -17,6 +17,13 @@ export interface CliWaitConfig {
     tool: string;
     /** Done when this returns `true` for a poll result. */
     done: (result: unknown) => boolean;
+    /**
+     * Terminal domain failure. A `true` result stops polling and turns the
+     * otherwise-successful tool payload into a `WAIT_FAILED` CLI failure. Checked
+     * before `done`, including for the initial result, so contradictory
+     * predicates fail closed.
+     */
+    failed?: (result: unknown) => boolean;
     /** Backoff schedule in seconds; the last entry repeats. Default `[2,3,5,5,8,10]`. */
     backoff?: number[];
     /** Max seconds before giving up. Default `600`. */
@@ -34,12 +41,14 @@ export interface PollParams {
     onTick?: (attempt: number, elapsedSec: number) => void;
     /** Injectable sleep for tests. */
     sleepFn?: (ms: number) => Promise<void>;
+    /** Explicit caller cancellation. Process SIGINT wiring remains application-owned. */
+    signal?: AbortSignal;
 }
 /**
  * Poll `wait.tool` until `wait.done` or the timeout. Returns the last poll
  * result; returns the initial result untouched when the initial call failed,
- * already satisfies `done`, or yields no poll target. A timeout produces a
- * `TIMEOUT` failed `ToolResult`.
+ * already satisfies `done`, or yields no poll target. A terminal result matched
+ * by `failed` produces `WAIT_FAILED`; a timeout produces `TIMEOUT`.
  */
 export declare function pollUntilDone(params: PollParams): Promise<ToolResult>;
 //# sourceMappingURL=cli-wait.d.ts.map

package/dist/tools/cli-wait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-wait.d.ts","sourceRoot":"","sources":["../../src/tools/cli-wait.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA0B3E"}
+{"version":3,"file":"cli-wait.d.ts","sourceRoot":"","sources":["../../src/tools/cli-wait.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACtC,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,qFAAqF;IACrF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAuC3E"}

package/dist/tools/cli.d.ts

@@ -29,6 +29,8 @@ export interface CliConfig<TAuth = unknown, TContext extends Record<string, unkn
      * when the CLI is built via `createToolkit<AppContext>()`.
      */
     context?: (auth: Awaited<TAuth> | undefined) => TContext;
+    /** Explicit cancellation for this invocation; applications may bind SIGINT to it. */
+    signal?: AbortSignal;
     /** Tool-call observability hooks — `afterToolCall` fires for every result,
      *  `onToolError` for the raw value behind a thrown one. */
     hooks?: ToolCallHooks;

package/dist/tools/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/tools/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/tools/cli.ts"],"names":[],"mappings":"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"}

package/dist/tools/define-download-tool.d.ts

@@ -1,17 +1,18 @@
 import type { ZodObject, z } from 'zod';
-import { DownloadResultSchema } from './download-core';
+import { ManagedFileRefSchema } from '../contract';
+import type { ManagedFileBoundary } from '../files/boundary';
 import { type ManagedNativeToolConfig } from './native-definition';
 import { type RuntimeToolDefinitionWithOutput, type RuntimeToolHandlerContext, type RuntimeToolPresenters } from './runtime-tool';
 export interface DefineDownloadToolConfig<TInput extends ZodObject> extends ManagedNativeToolConfig {
     input: TInput;
     resolveUrl: (input: z.output<TInput>, context: RuntimeToolHandlerContext<TInput>) => string | null | Promise<string | null>;
-    defaultDir: string;
-    dirFromInput?: (input: z.output<TInput>) => string | undefined;
+    files: ManagedFileBoundary;
+    pathFromInput?: (input: z.output<TInput>) => string | undefined;
     allowPrivateHosts?: boolean;
     maxBytes?: number;
     timeoutMs?: number;
-    present?: RuntimeToolPresenters<z.output<typeof DownloadResultSchema>>;
+    present?: RuntimeToolPresenters<z.output<typeof ManagedFileRefSchema>>;
 }
 /** Define one guarded managed download operation. */
-export declare function defineDownloadTool<TInput extends ZodObject>(config: DefineDownloadToolConfig<TInput>): RuntimeToolDefinitionWithOutput<TInput, typeof DownloadResultSchema>;
+export declare function defineDownloadTool<TInput extends ZodObject>(config: DefineDownloadToolConfig<TInput>): RuntimeToolDefinitionWithOutput<TInput, typeof ManagedFileRefSchema>;
 //# sourceMappingURL=define-download-tool.d.ts.map

package/dist/tools/define-download-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-download-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-download-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExC,OAAO,EAEL,oBAAoB,EAErB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,uBAAuB,EAAyB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,wBAAwB,CAAC,MAAM,SAAS,SAAS,CAChE,SAAQ,uBAAuB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,KACvC,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;CACxE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,SAAS,EACzD,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACvC,+BAA+B,CAAC,MAAM,EAAE,OAAO,oBAAoB,CAAC,CAgCtE"}
+{"version":3,"file":"define-download-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-download-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,EAAY,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,KAAK,uBAAuB,EAAyB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,wBAAwB,CAAC,MAAM,SAAS,SAAS,CAChE,SAAQ,uBAAuB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,KACvC,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAChE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;CACxE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,SAAS,EACzD,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACvC,+BAA+B,CAAC,MAAM,EAAE,OAAO,oBAAoB,CAAC,CAmCtE"}

package/dist/tools/define-upload-tool.d.ts

@@ -1,4 +1,5 @@
 import { type ZodType, z } from 'zod';
+import type { ManagedFileBoundary, ManagedFileSource } from '../files/boundary';
 import { type ManagedNativeToolConfig } from './native-definition';
 import { type RuntimeToolDefinitionWithOutput, type RuntimeToolHandlerContext, type RuntimeToolPresenters } from './runtime-tool';
 export declare const UploadToolInputSchema: z.ZodObject<{
@@ -6,7 +7,8 @@ export declare const UploadToolInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 export interface DefineUploadToolConfig<TOutput extends ZodType> extends ManagedNativeToolConfig {
     output: TOutput;
-    upload: (path: string, context: RuntimeToolHandlerContext<typeof UploadToolInputSchema>) => z.output<TOutput> | Promise<z.output<TOutput>>;
+    files: ManagedFileBoundary;
+    upload: (source: ManagedFileSource, context: RuntimeToolHandlerContext<typeof UploadToolInputSchema>) => z.output<TOutput> | Promise<z.output<TOutput>>;
     present?: RuntimeToolPresenters<z.output<TOutput>>;
 }
 /** Define one managed local-file upload operation. */

package/dist/tools/define-upload-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-upload-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-upload-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,KAAK,uBAAuB,EAAyB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,OAAO,CAC7D,SAAQ,uBAAuB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,yBAAyB,CAAC,OAAO,qBAAqB,CAAC,KAC7D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,OAAO,EACtD,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,GACtC,+BAA+B,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAC,CAiBxE"}
+{"version":3,"file":"define-upload-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-upload-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,KAAK,uBAAuB,EAAyB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,OAAO,CAC7D,SAAQ,uBAAuB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,CACN,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,yBAAyB,CAAC,OAAO,qBAAqB,CAAC,KAC7D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,OAAO,EACtD,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,GACtC,+BAA+B,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAC,CAyBxE"}