@sema-agent/core 1.279.0

package/dist/tools/fs/index.d.ts

@@ -0,0 +1,74 @@
+import type { AgentTool, ExecutionEnv } from "../../internal/harness.js";
+import type { BeforeWriteHook, ToolEffect } from "../../core/types.js";
+import { type TaskRegistry } from "../../core/task-registry.js";
+import { type ReadFileState } from "./safety.js";
+import { type ImageDownsampler } from "../../core/mcp.js";
+import { type PdfModelCapabilities } from "./pdf.js";
+export { pdfModelCapabilitiesOf, type PdfModelCapabilities } from "./pdf.js";
+export type ReadImageDownsamplerOption = ImageDownsampler | false | undefined;
+export declare const DEFAULT_COMMIT_COAUTHOR = "Claude Opus 4.8 <noreply@anthropic.com>";
+export declare function msTimeoutToSec(timeoutMs: number | undefined): number;
+export declare function seededFileUnchangedReminder(filePath: string): string;
+export declare function seedReadFileStateFromContext(state: ReadFileState, key: string, content: string): void;
+export interface CwdRef {
+    current: string;
+}
+export declare function makeReadFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: string, cwdRef?: CwdRef, additionalRoots?: readonly string[], imageDownsampler?: ReadImageDownsamplerOption, pdfCapabilities?: PdfModelCapabilities): AgentTool;
+export type { BeforeWriteRequest, BeforeWriteResult, BeforeWriteHook } from "../../core/types.js";
+export declare function makeEditFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: string, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook): AgentTool;
+export declare function makeWriteFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: string, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook): AgentTool;
+export declare function makeNotebookEditTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: string, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook): AgentTool;
+export declare function makeGrepTool(env: ExecutionEnv, rootCanonical: string, additionalRoots?: readonly string[]): AgentTool;
+export declare function makeGlobTool(env: ExecutionEnv, rootCanonical: string, additionalRoots?: readonly string[]): AgentTool;
+export declare const HAND_TOOL_EFFECTS: Readonly<Record<string, ToolEffect>>;
+export declare const BASH_READONLY_DEFAULT_ALLOW: readonly string[];
+export declare function parseLeadingCommandName(command: string): {
+    name: string;
+} | {
+    reject: string;
+};
+export declare function bashReversibilityProbe(allow?: readonly string[]): (args: unknown) => {
+    reversible: boolean;
+};
+export interface ExecClampOption {
+    deadlineMs: () => number | undefined;
+    onClamp?: (requestedSec: number, clampedSec: number) => void;
+}
+export declare function bashExitOneInterpretation(command: string): string | undefined;
+export declare function makeBashTool(env: ExecutionEnv, rootCanonical: string, coAuthor?: string | false, cwdRef?: CwdRef, taskOpts?: {
+    taskRegistry?: TaskRegistry;
+    taskOwner?: string;
+    taskScope?: string;
+    sessionId?: string;
+    onTaskNotification?: (n: import("../../core/task-notification.js").TaskNotificationPayload, opts?: {
+        priority?: "now" | "next" | "later";
+    }) => void;
+    detachHub?: import("../../core/tool-detach.js").ToolDetachHub;
+    execClamp?: ExecClampOption;
+}): AgentTool;
+export declare function makeBashReadonlyTool(env: ExecutionEnv, rootCanonical: string, allow: ReadonlySet<string>, execClamp?: ExecClampOption): AgentTool;
+export declare function makeBashOutputTool(env: ExecutionEnv): AgentTool;
+export declare function makeKillShellTool(env: ExecutionEnv, registry?: TaskRegistry): AgentTool;
+export interface HandsToolkitOptions {
+    additionalRoots?: readonly string[];
+    includeShell?: boolean;
+    readOnly?: boolean;
+    bashReadonlyAllow?: readonly string[];
+    commitCoAuthor?: string | false;
+    cwdRef?: CwdRef;
+    taskRegistry?: TaskRegistry;
+    taskOwner?: string;
+    taskScope?: string;
+    sessionId?: string;
+    mountBackgroundTaskTools?: boolean;
+    taskNotification?: (n: import("../../core/task-notification.js").TaskNotificationPayload, opts?: {
+        priority?: "now" | "next" | "later";
+    }) => void;
+    detachHub?: import("../../core/tool-detach.js").ToolDetachHub;
+    execClamp?: ExecClampOption;
+    readImageDownsampler?: ReadImageDownsamplerOption;
+    pdfModelCapabilities?: PdfModelCapabilities;
+    beforeWrite?: BeforeWriteHook;
+}
+export declare function createHandsToolkit(env: ExecutionEnv, readFileState: ReadFileState, rootCanonical: string, opts?: HandsToolkitOptions): AgentTool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/fs/index.d.ts.map

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