pulseed 0.4.15 → 0.4.17

package/dist/tools/types.d.ts

@@ -1,225 +0,0 @@
-import { z } from "zod";
-export declare const ToolResultSchema: z.ZodObject<{
-    /** Whether the tool invocation succeeded */
-    success: z.ZodBoolean;
-    /** The output data (type depends on tool) */
-    data: z.ZodUnknown;
-    /** Human-readable summary of the result */
-    summary: z.ZodString;
-    /** Optional error message on failure */
-    error: z.ZodOptional<z.ZodString>;
-    /** Duration of the tool call in milliseconds */
-    durationMs: z.ZodNumber;
-    /** Optional context modifier: instructions to append to subsequent LLM context */
-    contextModifier: z.ZodOptional<z.ZodString>;
-    /**
-     * Optional output artifacts (file paths read, URLs fetched, etc.)
-     * Used by verification to trace what the tool accessed.
-     */
-    artifacts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** Set when output was truncated; contains the original character count */
-    truncated: z.ZodOptional<z.ZodObject<{
-        originalChars: z.ZodNumber;
-        overflowPath: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        originalChars: number;
-        overflowPath?: string | undefined;
-    }, {
-        originalChars: number;
-        overflowPath?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    success: boolean;
-    summary: string;
-    durationMs: number;
-    error?: string | undefined;
-    data?: unknown;
-    contextModifier?: string | undefined;
-    artifacts?: string[] | undefined;
-    truncated?: {
-        originalChars: number;
-        overflowPath?: string | undefined;
-    } | undefined;
-}, {
-    success: boolean;
-    summary: string;
-    durationMs: number;
-    error?: string | undefined;
-    data?: unknown;
-    contextModifier?: string | undefined;
-    artifacts?: string[] | undefined;
-    truncated?: {
-        originalChars: number;
-        overflowPath?: string | undefined;
-    } | undefined;
-}>;
-export type ToolResult = z.infer<typeof ToolResultSchema>;
-export declare const ToolPermissionLevelSchema: z.ZodEnum<["read_only", "read_metrics", "write_local", "execute", "write_remote"]>;
-export type ToolPermissionLevel = z.infer<typeof ToolPermissionLevelSchema>;
-export declare const ToolMetadataSchema: z.ZodObject<{
-    /** Unique tool name (e.g., "glob", "shell") */
-    name: z.ZodString;
-    /** Alternative names for discovery */
-    aliases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    /** Permission level */
-    permissionLevel: z.ZodEnum<["read_only", "read_metrics", "write_local", "execute", "write_remote"]>;
-    /** Whether this tool is read-only (no side effects) */
-    isReadOnly: z.ZodBoolean;
-    /** Whether this tool can cause irreversible changes */
-    isDestructive: z.ZodBoolean;
-    /**
-     * Whether to defer loading this tool from the LLM context.
-     * Deferred tools are hidden from the LLM tool list until explicitly
-     * searched for via a ToolSearch mechanism. This saves context budget
-     * for rarely-used tools.
-     */
-    shouldDefer: z.ZodDefault<z.ZodBoolean>;
-    /** Whether this tool should always be loaded into context */
-    alwaysLoad: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum concurrent invocations (0 = unlimited) */
-    maxConcurrency: z.ZodDefault<z.ZodNumber>;
-    /** Maximum characters of tool output to pass to LLM (excess persisted to disk) */
-    maxOutputChars: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Tags for categorization and filtering.
-     * Used by the context-filtered tier of the registry.
-     */
-    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    tags: string[];
-    aliases: string[];
-    permissionLevel: "read_only" | "read_metrics" | "write_local" | "execute" | "write_remote";
-    isReadOnly: boolean;
-    isDestructive: boolean;
-    shouldDefer: boolean;
-    alwaysLoad: boolean;
-    maxConcurrency: number;
-    maxOutputChars: number;
-}, {
-    name: string;
-    permissionLevel: "read_only" | "read_metrics" | "write_local" | "execute" | "write_remote";
-    isReadOnly: boolean;
-    isDestructive: boolean;
-    tags?: string[] | undefined;
-    aliases?: string[] | undefined;
-    shouldDefer?: boolean | undefined;
-    alwaysLoad?: boolean | undefined;
-    maxConcurrency?: number | undefined;
-    maxOutputChars?: number | undefined;
-}>;
-export type ToolMetadata = z.infer<typeof ToolMetadataSchema>;
-/**
- * Core tool interface. Every tool (built-in or plugin-provided) implements this.
- *
- * Generic parameters:
- *   TInput  - Zod-validated input type
- *   TOutput - Structured output type (wrapped in ToolResult)
- */
-export interface ITool<TInput = unknown, TOutput = unknown> {
-    /** Tool metadata (name, permissions, etc.) */
-    readonly metadata: ToolMetadata;
-    /** Zod schema for input validation (gate 1 of the executor pipeline) */
-    readonly inputSchema: z.ZodType<TInput, z.ZodTypeDef, any>;
-    /**
-     * Dynamic description that may change per invocation context.
-     * The LLM sees this description when deciding whether to use the tool.
-     * Context parameters allow the description to adapt (e.g., showing
-     * current working directory for file tools).
-     */
-    description(context?: ToolDescriptionContext): string;
-    /**
-     * Execute the tool. Input has already been validated by inputSchema.
-     * Returns a ToolResult containing the output and metadata.
-     */
-    call(input: TInput, context: ToolCallContext): Promise<ToolResult>;
-    /**
-     * Check whether the tool can be invoked with the given input.
-     * This is gate 2 of the executor pipeline (semantic validation).
-     * Returns null if OK, or a rejection reason string.
-     */
-    checkPermissions(input: TInput, context: ToolCallContext): Promise<PermissionCheckResult>;
-    /**
-     * Whether this tool can be safely invoked concurrently with the given input.
-     * This is INPUT-DEPENDENT: e.g., two Read calls to different files = safe;
-     * two Shell calls to the same cwd = unsafe (potential interference).
-     */
-    isConcurrencySafe(input: TInput): boolean;
-}
-export interface ToolDescriptionContext {
-    /** Current working directory (for file-related tools) */
-    cwd?: string;
-    /** Goal context (so tools can tailor their description) */
-    goalId?: string;
-    /** Available data sources */
-    dataSources?: string[];
-}
-export interface ToolCallContext {
-    /** Current working directory */
-    cwd: string;
-    /** Goal ID for trust/permission lookups */
-    goalId: string;
-    /** Trust balance for the current context */
-    trustBalance: number;
-    /** Whether the user has pre-approved certain operations */
-    preApproved: boolean;
-    /** Approval callback for interactive permission requests */
-    approvalFn: (request: ApprovalRequest) => Promise<boolean>;
-    /** Optional hook emitted before approvalFn is invoked */
-    onApprovalRequested?: (request: ApprovalRequest & {
-        callId?: string;
-    }) => Promise<void> | void;
-    /** When true, bypass DENY_PATTERNS in ShellTool (internal use only) */
-    trusted?: boolean;
-    /** Abort signal for cancellation */
-    abortSignal?: AbortSignal;
-    /** Timeout in milliseconds (per-tool-call) */
-    timeoutMs?: number;
-    /** Session identifier for correlation in audit logs */
-    sessionId?: string;
-    /** Unique call identifier for correlation in audit logs */
-    callId?: string;
-    /** Optional logger for audit-trail events */
-    logger?: {
-        debug: (msg: string, meta?: Record<string, unknown>) => void;
-        warn: (msg: string, meta?: Record<string, unknown>) => void;
-        error: (msg: string, meta?: Record<string, unknown>) => void;
-    };
-    /** When true, gates pass but tool.call() is skipped (for testing pipelines) */
-    dryRun?: boolean;
-}
-export interface ApprovalRequest {
-    toolName: string;
-    input: unknown;
-    reason: string;
-    permissionLevel: ToolPermissionLevel;
-    isDestructive: boolean;
-    reversibility: "reversible" | "irreversible" | "unknown";
-}
-export declare const PermissionCheckResultSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
-    status: z.ZodLiteral<"allowed">;
-}, "strip", z.ZodTypeAny, {
-    status: "allowed";
-}, {
-    status: "allowed";
-}>, z.ZodObject<{
-    status: z.ZodLiteral<"denied">;
-    reason: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: "denied";
-    reason: string;
-}, {
-    status: "denied";
-    reason: string;
-}>, z.ZodObject<{
-    status: z.ZodLiteral<"needs_approval">;
-    reason: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: "needs_approval";
-    reason: string;
-}, {
-    status: "needs_approval";
-    reason: string;
-}>]>;
-export type PermissionCheckResult = z.infer<typeof PermissionCheckResultSchema>;
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/types.js

@@ -1,71 +0,0 @@
-import { z } from "zod";
-// --- Tool Result ---
-export const ToolResultSchema = z.object({
-    /** Whether the tool invocation succeeded */
-    success: z.boolean(),
-    /** The output data (type depends on tool) */
-    data: z.unknown(),
-    /** Human-readable summary of the result */
-    summary: z.string(),
-    /** Optional error message on failure */
-    error: z.string().optional(),
-    /** Duration of the tool call in milliseconds */
-    durationMs: z.number(),
-    /** Optional context modifier: instructions to append to subsequent LLM context */
-    contextModifier: z.string().optional(),
-    /**
-     * Optional output artifacts (file paths read, URLs fetched, etc.)
-     * Used by verification to trace what the tool accessed.
-     */
-    artifacts: z.array(z.string()).optional(),
-    /** Set when output was truncated; contains the original character count */
-    truncated: z.object({
-        originalChars: z.number(),
-        overflowPath: z.string().optional()
-    }).optional(),
-});
-// --- Permission Level ---
-export const ToolPermissionLevelSchema = z.enum([
-    "read_only", // No side effects: Glob, Grep, Read, HttpFetch(GET), JsonQuery
-    "read_metrics", // Reads with potential side effects (Shell for metrics: spawns processes)
-    "write_local", // Local filesystem writes (future: Write, Edit)
-    "execute", // Arbitrary execution (future: Shell with side effects)
-    "write_remote", // Remote side effects (future: HttpFetch POST/PUT/DELETE)
-]);
-// --- Tool Metadata ---
-export const ToolMetadataSchema = z.object({
-    /** Unique tool name (e.g., "glob", "shell") */
-    name: z.string(),
-    /** Alternative names for discovery */
-    aliases: z.array(z.string()).default([]),
-    /** Permission level */
-    permissionLevel: ToolPermissionLevelSchema,
-    /** Whether this tool is read-only (no side effects) */
-    isReadOnly: z.boolean(),
-    /** Whether this tool can cause irreversible changes */
-    isDestructive: z.boolean(),
-    /**
-     * Whether to defer loading this tool from the LLM context.
-     * Deferred tools are hidden from the LLM tool list until explicitly
-     * searched for via a ToolSearch mechanism. This saves context budget
-     * for rarely-used tools.
-     */
-    shouldDefer: z.boolean().default(false),
-    /** Whether this tool should always be loaded into context */
-    alwaysLoad: z.boolean().default(false),
-    /** Maximum concurrent invocations (0 = unlimited) */
-    maxConcurrency: z.number().default(0),
-    /** Maximum characters of tool output to pass to LLM (excess persisted to disk) */
-    maxOutputChars: z.number().default(8000),
-    /**
-     * Tags for categorization and filtering.
-     * Used by the context-filtered tier of the registry.
-     */
-    tags: z.array(z.string()).default([]),
-});
-export const PermissionCheckResultSchema = z.discriminatedUnion("status", [
-    z.object({ status: z.literal("allowed") }),
-    z.object({ status: z.literal("denied"), reason: z.string() }),
-    z.object({ status: z.literal("needs_approval"), reason: z.string() }),
-]);
-//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

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