@graphrefly/ts 0.0.1 → 0.0.2

package/dist/executors/tool-provider-adapters.d.cts

@@ -0,0 +1,174 @@
+import { DataIssue } from '../data/index.cjs';
+import { d as Graph } from '../graph-CWK3HLPB.cjs';
+import { N as Node } from '../types-BS6CyR-x.cjs';
+import { S as SourceRef, E as ExecutorOutcome, A as AgentRequestStatusChanged, a as AgentRuntimeAuditRecord } from '../agent-runtime-types-core-CaXfKNtY.cjs';
+import { T as ToolProviderCatalog, a as ToolProviderAdapterRunRequested, b as ToolProviderAdapterRunStatus, c as ToolProviderAdapterInput, d as ToolProviderPublicTextPolicy, e as ToolProviderAdapterBinding } from '../agent-runtime-types-tool-DninPEzk.cjs';
+import '../core/index.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../codec-BB7p8fJc.cjs';
+import '../describe-CQRrkv-Q.cjs';
+import '../types-XDoqxYO9.cjs';
+import '../resilience-Dig3Q7n0.cjs';
+import '../scheduled-readiness-DpRY8jI0.cjs';
+
+/**
+ * Concrete Layer C tool-provider adapter pack v0 (D283/D359-D362).
+ *
+ * Adapter factories return graph-visible catalog DATA plus runtime-private
+ * bindings. Permission checks are enforced by the binding closure; catalog
+ * policy remains descriptive admission/routing/audit material, not a security
+ * boundary.
+ */
+
+interface ToolProviderAdapterPack<TArguments = unknown, TResult = unknown> {
+    readonly catalogs: readonly ToolProviderCatalog[];
+    readonly bindings: readonly ToolProviderAdapterBinding<TArguments, TResult>[];
+}
+type LocalBuiltinToolName = "date.now" | "json.parse" | "text.concat";
+interface LocalBuiltinToolArguments {
+    readonly text?: string;
+    readonly parts?: readonly unknown[];
+    readonly separator?: string;
+}
+type LocalBuiltinToolResult = {
+    readonly toolName: "date.now";
+    readonly epochMs: number;
+    readonly iso: string;
+} | {
+    readonly toolName: "json.parse";
+    readonly value: unknown;
+} | {
+    readonly toolName: "text.concat";
+    readonly text: string;
+};
+interface LocalBuiltinToolProviderBindingOptions {
+    readonly providerId?: string;
+    readonly now?: () => number;
+    readonly maxTextChars?: number;
+}
+interface LocalBuiltinToolProviderAdapterPackOptions extends LocalBuiltinToolProviderBindingOptions {
+    readonly executorId?: string;
+    readonly profileId?: string;
+    readonly publicText?: ToolProviderPublicTextPolicy;
+}
+interface ProcessToolArguments {
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly input?: string;
+}
+interface ProcessToolResult {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly exitCode: number | null;
+    readonly signal?: string;
+    readonly outputPreview?: string;
+    readonly errorPreview?: string;
+    readonly outputBytes: number;
+    readonly errorOutputBytes: number;
+    readonly truncated: boolean;
+}
+interface ProcessToolAllowedCommand {
+    /** Public command key accepted in tool arguments. */
+    readonly command: string;
+    /** Runtime executable. Defaults to `command`. This stays binding-private. */
+    readonly executable?: string;
+    readonly fixedArgs?: readonly string[];
+    /** Explicit argv policy. `true` allows any argv array; omitted means no extra args. */
+    readonly allowArgs?: true | readonly string[] | ((args: readonly string[]) => boolean);
+    readonly cwd?: string;
+}
+interface ProcessToolProviderBindingOptions {
+    readonly providerId?: string;
+    readonly allowedCommands?: readonly ProcessToolAllowedCommand[];
+    readonly workingDirectory?: string;
+    readonly allowedWorkingDirectories?: readonly string[];
+    readonly baseEnv?: Readonly<Record<string, string>>;
+    readonly allowedEnvKeys?: readonly string[];
+    readonly timeoutMs?: number;
+    readonly maxOutputBytes?: number;
+    readonly maxSummaryChars?: number;
+}
+interface ProcessToolProviderAdapterPackOptions extends ProcessToolProviderBindingOptions {
+    readonly executorId?: string;
+    readonly profileId?: string;
+}
+interface HttpToolArguments {
+    readonly url?: string;
+    readonly method?: string;
+    readonly headers?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly body?: string;
+}
+interface HttpToolResult {
+    readonly url: string;
+    readonly method: string;
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly bodyPreview?: string;
+    readonly bodyText?: string;
+    readonly bodyBytes: number;
+    readonly bodyTruncated: boolean;
+    readonly dataMode: "inline" | "summary" | "ref";
+    readonly bodyRef?: SourceRef;
+}
+interface HttpToolProviderDriverRequest {
+    readonly url: string;
+    readonly method: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: string;
+    readonly signal?: AbortSignal;
+}
+interface HttpToolProviderDriverResponse {
+    readonly url?: string;
+    readonly status: number;
+    readonly statusText?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly bodyText?: string;
+    readonly bodyBytes?: number;
+    readonly bodyRef?: SourceRef;
+}
+interface HttpToolProviderDriver {
+    fetch(request: HttpToolProviderDriverRequest): HttpToolProviderDriverResponse | PromiseLike<HttpToolProviderDriverResponse>;
+}
+interface HttpToolProviderRuntimeOptions {
+    readonly name?: string;
+    readonly providerId?: string;
+    readonly executorId?: string;
+    readonly profileId?: string;
+    readonly inputs: Node<ToolProviderAdapterInput<HttpToolArguments>>;
+    readonly runRequests?: readonly Node<ToolProviderAdapterRunRequested>[];
+    readonly autoRunReadyInputs?: boolean;
+    readonly allowedOrigins?: readonly string[];
+    readonly allowedMethods?: readonly string[];
+    readonly allowedRequestHeaders?: readonly string[];
+    readonly exposedResponseHeaders?: readonly string[];
+    readonly timeoutMs?: number;
+    readonly maxResponseBytes?: number;
+    readonly maxInlineBodyChars?: number;
+    readonly approvalMode?: "auto" | "require" | "never";
+    readonly driver?: HttpToolProviderDriver;
+    readonly now?: () => number;
+    readonly publicText?: ToolProviderPublicTextPolicy;
+}
+interface HttpToolProviderRuntimeBundle {
+    readonly catalogs: readonly ToolProviderCatalog[];
+    readonly runRequests: Node<ToolProviderAdapterRunRequested>;
+    readonly runStatus: Node<ToolProviderAdapterRunStatus>;
+    readonly outcomes: Node<ExecutorOutcome<HttpToolResult>>;
+    readonly status: Node<AgentRequestStatusChanged>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+    dispose(): void;
+}
+declare function localBuiltinToolProviderBinding(opts?: LocalBuiltinToolProviderBindingOptions): ToolProviderAdapterBinding<LocalBuiltinToolArguments, LocalBuiltinToolResult>;
+declare function localBuiltinToolProviderAdapterPack(opts?: LocalBuiltinToolProviderAdapterPackOptions): ToolProviderAdapterPack<LocalBuiltinToolArguments, LocalBuiltinToolResult>;
+declare function processToolProviderBinding(opts?: ProcessToolProviderBindingOptions): ToolProviderAdapterBinding<ProcessToolArguments, ProcessToolResult>;
+declare function processToolProviderAdapterPack(opts?: ProcessToolProviderAdapterPackOptions): ToolProviderAdapterPack<ProcessToolArguments, ProcessToolResult>;
+declare function processToolProviderCatalog(opts?: ProcessToolProviderAdapterPackOptions): ToolProviderCatalog;
+declare function httpToolProviderCatalog(opts?: Omit<HttpToolProviderRuntimeOptions, "inputs" | "runRequests" | "driver">): ToolProviderCatalog;
+declare function httpToolProviderRuntime(graph: Graph, opts: HttpToolProviderRuntimeOptions): HttpToolProviderRuntimeBundle;
+
+export { type HttpToolArguments, type HttpToolProviderDriver, type HttpToolProviderDriverRequest, type HttpToolProviderDriverResponse, type HttpToolProviderRuntimeBundle, type HttpToolProviderRuntimeOptions, type HttpToolResult, type LocalBuiltinToolArguments, type LocalBuiltinToolName, type LocalBuiltinToolProviderAdapterPackOptions, type LocalBuiltinToolProviderBindingOptions, type LocalBuiltinToolResult, type ProcessToolAllowedCommand, type ProcessToolArguments, type ProcessToolProviderAdapterPackOptions, type ProcessToolProviderBindingOptions, type ProcessToolResult, type ToolProviderAdapterPack, httpToolProviderCatalog, httpToolProviderRuntime, localBuiltinToolProviderAdapterPack, localBuiltinToolProviderBinding, processToolProviderAdapterPack, processToolProviderBinding, processToolProviderCatalog };

package/dist/executors/tool-provider-adapters.d.ts

@@ -0,0 +1,174 @@
+import { DataIssue } from '../data/index.js';
+import { d as Graph } from '../graph-ho5sotHP.js';
+import { N as Node } from '../types-C9NOgNJw.js';
+import { S as SourceRef, E as ExecutorOutcome, A as AgentRequestStatusChanged, a as AgentRuntimeAuditRecord } from '../agent-runtime-types-core-hU299uIC.js';
+import { T as ToolProviderCatalog, a as ToolProviderAdapterRunRequested, b as ToolProviderAdapterRunStatus, c as ToolProviderAdapterInput, d as ToolProviderPublicTextPolicy, e as ToolProviderAdapterBinding } from '../agent-runtime-types-tool-BEpSINol.js';
+import '../core/index.js';
+import '../messages-CAzUPPJM.js';
+import '../codec-BB7p8fJc.js';
+import '../describe-B_A5fbXH.js';
+import '../types-DL_05n2M.js';
+import '../resilience-Dig3Q7n0.js';
+import '../scheduled-readiness-5rwQlyjV.js';
+
+/**
+ * Concrete Layer C tool-provider adapter pack v0 (D283/D359-D362).
+ *
+ * Adapter factories return graph-visible catalog DATA plus runtime-private
+ * bindings. Permission checks are enforced by the binding closure; catalog
+ * policy remains descriptive admission/routing/audit material, not a security
+ * boundary.
+ */
+
+interface ToolProviderAdapterPack<TArguments = unknown, TResult = unknown> {
+    readonly catalogs: readonly ToolProviderCatalog[];
+    readonly bindings: readonly ToolProviderAdapterBinding<TArguments, TResult>[];
+}
+type LocalBuiltinToolName = "date.now" | "json.parse" | "text.concat";
+interface LocalBuiltinToolArguments {
+    readonly text?: string;
+    readonly parts?: readonly unknown[];
+    readonly separator?: string;
+}
+type LocalBuiltinToolResult = {
+    readonly toolName: "date.now";
+    readonly epochMs: number;
+    readonly iso: string;
+} | {
+    readonly toolName: "json.parse";
+    readonly value: unknown;
+} | {
+    readonly toolName: "text.concat";
+    readonly text: string;
+};
+interface LocalBuiltinToolProviderBindingOptions {
+    readonly providerId?: string;
+    readonly now?: () => number;
+    readonly maxTextChars?: number;
+}
+interface LocalBuiltinToolProviderAdapterPackOptions extends LocalBuiltinToolProviderBindingOptions {
+    readonly executorId?: string;
+    readonly profileId?: string;
+    readonly publicText?: ToolProviderPublicTextPolicy;
+}
+interface ProcessToolArguments {
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly input?: string;
+}
+interface ProcessToolResult {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly exitCode: number | null;
+    readonly signal?: string;
+    readonly outputPreview?: string;
+    readonly errorPreview?: string;
+    readonly outputBytes: number;
+    readonly errorOutputBytes: number;
+    readonly truncated: boolean;
+}
+interface ProcessToolAllowedCommand {
+    /** Public command key accepted in tool arguments. */
+    readonly command: string;
+    /** Runtime executable. Defaults to `command`. This stays binding-private. */
+    readonly executable?: string;
+    readonly fixedArgs?: readonly string[];
+    /** Explicit argv policy. `true` allows any argv array; omitted means no extra args. */
+    readonly allowArgs?: true | readonly string[] | ((args: readonly string[]) => boolean);
+    readonly cwd?: string;
+}
+interface ProcessToolProviderBindingOptions {
+    readonly providerId?: string;
+    readonly allowedCommands?: readonly ProcessToolAllowedCommand[];
+    readonly workingDirectory?: string;
+    readonly allowedWorkingDirectories?: readonly string[];
+    readonly baseEnv?: Readonly<Record<string, string>>;
+    readonly allowedEnvKeys?: readonly string[];
+    readonly timeoutMs?: number;
+    readonly maxOutputBytes?: number;
+    readonly maxSummaryChars?: number;
+}
+interface ProcessToolProviderAdapterPackOptions extends ProcessToolProviderBindingOptions {
+    readonly executorId?: string;
+    readonly profileId?: string;
+}
+interface HttpToolArguments {
+    readonly url?: string;
+    readonly method?: string;
+    readonly headers?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly body?: string;
+}
+interface HttpToolResult {
+    readonly url: string;
+    readonly method: string;
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly bodyPreview?: string;
+    readonly bodyText?: string;
+    readonly bodyBytes: number;
+    readonly bodyTruncated: boolean;
+    readonly dataMode: "inline" | "summary" | "ref";
+    readonly bodyRef?: SourceRef;
+}
+interface HttpToolProviderDriverRequest {
+    readonly url: string;
+    readonly method: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: string;
+    readonly signal?: AbortSignal;
+}
+interface HttpToolProviderDriverResponse {
+    readonly url?: string;
+    readonly status: number;
+    readonly statusText?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly bodyText?: string;
+    readonly bodyBytes?: number;
+    readonly bodyRef?: SourceRef;
+}
+interface HttpToolProviderDriver {
+    fetch(request: HttpToolProviderDriverRequest): HttpToolProviderDriverResponse | PromiseLike<HttpToolProviderDriverResponse>;
+}
+interface HttpToolProviderRuntimeOptions {
+    readonly name?: string;
+    readonly providerId?: string;
+    readonly executorId?: string;
+    readonly profileId?: string;
+    readonly inputs: Node<ToolProviderAdapterInput<HttpToolArguments>>;
+    readonly runRequests?: readonly Node<ToolProviderAdapterRunRequested>[];
+    readonly autoRunReadyInputs?: boolean;
+    readonly allowedOrigins?: readonly string[];
+    readonly allowedMethods?: readonly string[];
+    readonly allowedRequestHeaders?: readonly string[];
+    readonly exposedResponseHeaders?: readonly string[];
+    readonly timeoutMs?: number;
+    readonly maxResponseBytes?: number;
+    readonly maxInlineBodyChars?: number;
+    readonly approvalMode?: "auto" | "require" | "never";
+    readonly driver?: HttpToolProviderDriver;
+    readonly now?: () => number;
+    readonly publicText?: ToolProviderPublicTextPolicy;
+}
+interface HttpToolProviderRuntimeBundle {
+    readonly catalogs: readonly ToolProviderCatalog[];
+    readonly runRequests: Node<ToolProviderAdapterRunRequested>;
+    readonly runStatus: Node<ToolProviderAdapterRunStatus>;
+    readonly outcomes: Node<ExecutorOutcome<HttpToolResult>>;
+    readonly status: Node<AgentRequestStatusChanged>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+    dispose(): void;
+}
+declare function localBuiltinToolProviderBinding(opts?: LocalBuiltinToolProviderBindingOptions): ToolProviderAdapterBinding<LocalBuiltinToolArguments, LocalBuiltinToolResult>;
+declare function localBuiltinToolProviderAdapterPack(opts?: LocalBuiltinToolProviderAdapterPackOptions): ToolProviderAdapterPack<LocalBuiltinToolArguments, LocalBuiltinToolResult>;
+declare function processToolProviderBinding(opts?: ProcessToolProviderBindingOptions): ToolProviderAdapterBinding<ProcessToolArguments, ProcessToolResult>;
+declare function processToolProviderAdapterPack(opts?: ProcessToolProviderAdapterPackOptions): ToolProviderAdapterPack<ProcessToolArguments, ProcessToolResult>;
+declare function processToolProviderCatalog(opts?: ProcessToolProviderAdapterPackOptions): ToolProviderCatalog;
+declare function httpToolProviderCatalog(opts?: Omit<HttpToolProviderRuntimeOptions, "inputs" | "runRequests" | "driver">): ToolProviderCatalog;
+declare function httpToolProviderRuntime(graph: Graph, opts: HttpToolProviderRuntimeOptions): HttpToolProviderRuntimeBundle;
+
+export { type HttpToolArguments, type HttpToolProviderDriver, type HttpToolProviderDriverRequest, type HttpToolProviderDriverResponse, type HttpToolProviderRuntimeBundle, type HttpToolProviderRuntimeOptions, type HttpToolResult, type LocalBuiltinToolArguments, type LocalBuiltinToolName, type LocalBuiltinToolProviderAdapterPackOptions, type LocalBuiltinToolProviderBindingOptions, type LocalBuiltinToolResult, type ProcessToolAllowedCommand, type ProcessToolArguments, type ProcessToolProviderAdapterPackOptions, type ProcessToolProviderBindingOptions, type ProcessToolResult, type ToolProviderAdapterPack, httpToolProviderCatalog, httpToolProviderRuntime, localBuiltinToolProviderAdapterPack, localBuiltinToolProviderBinding, processToolProviderAdapterPack, processToolProviderBinding, processToolProviderCatalog };