eve-hub 0.5.2 → 0.5.3

package/channels/eve-roster-user.d.ts

@@ -1,2 +1,2 @@
-declare const _default: any;
+declare const _default: import("eve/channels/eve").EveChannel;
 export default _default;

package/connections/vercel-kit.d.ts

@@ -1,2 +1,2 @@
-declare const _default: any;
+declare const _default: import("eve").DynamicSentinel<import("eve/connections").DynamicConnectionResult>;
 export default _default;

package/hooks/mention-gate.d.ts

@@ -1,2 +1,2 @@
-declare const _default: any;
+declare const _default: import("eve/hooks").HookDefinition<"message.received">;
 export default _default;

package/hooks/sandbox.d.ts

@@ -1,2 +1,2 @@
-declare const _default: any;
+declare const _default: import("eve/hooks").HookDefinition<"turn.started">;
 export default _default;

package/host-sandbox.d.ts

@@ -33,7 +33,11 @@ export declare function hostEnvironment(options?: HostOptions): {
         session: SessionRef;
     }, _open: unknown, artifact: HostArtifact): Promise<{
         handle: {
-            sandbox: any;
+            sandbox: SandboxSession & {
+                description: string;
+                root: string;
+                worktree?: SessionWorktree;
+            };
             onRuntimeShutdown: () => Promise<void>;
             onSessionStop: () => Promise<void>;
             onSessionDelete: () => Promise<void>;
@@ -43,15 +47,23 @@ export declare function hostEnvironment(options?: HostOptions): {
     resume(ctx: {
         session: SessionRef;
     }, _artifact: unknown, state: HostState): Promise<{
-        sandbox: any;
+        sandbox: SandboxSession & {
+            description: string;
+            root: string;
+            worktree?: SessionWorktree;
+        };
         onRuntimeShutdown: () => Promise<void>;
         onSessionStop: () => Promise<void>;
         onSessionDelete: () => Promise<void>;
     }>;
 };
-export declare const HostSandbox: any;
+export declare const HostSandbox: import("eve/sandbox/provider").SandboxProvider<HostOptions, undefined, SandboxSession>;
 export declare function hostHandle(rootOrState: string | HostState, sessionId: string): {
-    sandbox: any;
+    sandbox: SandboxSession & {
+        description: string;
+        root: string;
+        worktree?: SessionWorktree;
+    };
     onRuntimeShutdown: () => Promise<void>;
     onSessionStop: () => Promise<void>;
     onSessionDelete: () => Promise<void>;

package/instructions/main.d.ts

@@ -1,2 +1,4 @@
-declare const _default: any;
+declare const _default: {
+    content: any;
+};
 export default _default;

package/instructions/protocol.d.ts

@@ -1,2 +1,4 @@
-declare const _default: any;
+declare const _default: {
+    content: any;
+};
 export default _default;

package/memory/bot.d.ts

@@ -1,2 +1,17 @@
-declare const _default: any;
+declare const recall: ({ messages }: {
+    messages: readonly unknown[];
+}) => {
+    messages: any;
+};
+declare const _default: import("eve/memory").DefinedMemory<{
+    readonly description: "Standing decisions for this bot only, from its agents/<bot>/memory/ directory.";
+    readonly namespace: "hub-bot-memory";
+    readonly scope: () => any;
+    readonly provider: {
+        readonly recall: {
+            "turn.started": typeof recall;
+            "compaction.completed": typeof recall;
+        };
+    };
+}>;
 export default _default;

package/memory/workspace.d.ts

@@ -1,2 +1,17 @@
-declare const _default: any;
+declare const recall: ({ messages }: {
+    messages: readonly unknown[];
+}) => {
+    messages: any;
+};
+declare const _default: import("eve/memory").DefinedMemory<{
+    readonly description: "The human's standing decisions for this workspace, from its memory/ directory.";
+    readonly namespace: "hub-workspace-memory";
+    readonly scope: "workspace";
+    readonly provider: {
+        readonly recall: {
+            "turn.started": typeof recall;
+            "compaction.completed": typeof recall;
+        };
+    };
+}>;
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-hub",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "license": "Apache-2.0",
   "description": "Bot-side code shared by every hub agent: registry tools, the roster hook, the eve channel, the host sandbox and browser, and model helpers.",
   "type": "module",
@@ -32,4 +32,4 @@
     "@vercel/connect": "^2.4.1",
     "@vercel/oidc": "4.0.0"
   }
-}
+}

package/schedules/classify.d.ts

@@ -1,2 +1,5 @@
-declare const _default: any;
+declare const _default: {
+    cron: string;
+    run(): Promise<void>;
+};
 export default _default;

package/schedules/compact.d.ts

@@ -1,2 +1,5 @@
-declare const _default: any;
+declare const _default: {
+    cron: string;
+    run(): Promise<void>;
+};
 export default _default;

package/schedules/dash.d.ts

@@ -1,2 +1,5 @@
-declare const _default: any;
+declare const _default: {
+    cron: string;
+    run(): Promise<void>;
+};
 export default _default;

package/schedules/hub.d.mts

@@ -0,0 +1,26 @@
+// Types for hub.mjs: main's schedules' client of the hub's HTTP API. Bodies
+// the schedules only pass through are `unknown`.
+import type { DashEntries } from '../../../registry/dash.mjs';
+
+type Notice = { schedule: string; text: string; clientId?: string };
+type Post = { text: string; clientId?: string };
+type Ok = { ok: true };
+export type Hub = {
+  snapshot(): Promise<Record<string, unknown>>;
+  roster(): Promise<unknown>;
+  load(id: string): Promise<unknown>;
+  loadVersioned(id: string): Promise<{ state: unknown; savedAt: string | null }>;
+  save(id: string, state: unknown): Promise<unknown>;
+  commit(id: string, withState: { state?: unknown }, posts: Post[]): Promise<unknown>;
+  post(id: string, text: string, key?: string): Promise<unknown>;
+  compact(threadId: string, bot: string, by: string, report?: { trigger?: string; reportTo?: string }): Promise<{ status: number; ok: boolean; body: unknown }>;
+  dashChecked(): Promise<Ok & { checkedAt: string }>;
+  dashClassified(): Promise<Ok & { classifiedAt: string }>;
+  fileThread(threadId: string, path: string): Promise<unknown>;
+  dashEntries(entries: object[], remove?: string[], notice?: Notice | null): Promise<Ok & { entries: DashEntries }>;
+};
+export function createHub(options?: { base?: string; agent?: string; fetchImpl?: typeof fetch }): Hub;
+export const POST_MAX_BYTES: number;
+export const POSTS_PER_COMMIT: number;
+export function toPosts(notices: string[]): string[];
+export function runOnce(hub: Hub, id: string, decide: (snap: Record<string, unknown> | null, saved: unknown, now: number) => unknown, options?: { now?: number; snapshot?: boolean }): Promise<{ posts: Post[]; state: unknown }>;

package/schedules/hub.mjs

@@ -43,9 +43,9 @@ export function createHub({ base = registryBase(), agent = "main", fetchImpl = f
     // this compaction's report lines into that schedule's thread itself.
     compact: (threadId, bot, by, report = {}) => call(`/api/threads/${encodeURIComponent(threadId)}/compact`, { method: "POST", body: JSON.stringify({ agent: bot, by, ...report }) }),
     // The Dash was scanned now (registry/dash.mjs checkedAt), changed or not.
-    dashChecked: () => must("/api/dash/checked", { method: "POST", body: "{}" }),
+    dashChecked: () => must("/api/dash/checked", { method: "POST", body: JSON.stringify({ by: agent }) }),
     // A classifier pass finished (registry/dash.mjs classifiedAt).
-    dashClassified: () => must("/api/dash/classified", { method: "POST", body: "{}" }),
+    dashClassified: () => must("/api/dash/classified", { method: "POST", body: JSON.stringify({ by: agent }) }),
     // Dash entries from the classifier (registry/dash.mjs), merged per field.
     // File an unfiled thread into a track (the classifier's pick), as a bot:
     // the hub refuses a thread that's already filed and doesn't lock it.

package/schedules/prune.d.ts

@@ -1,2 +1,5 @@
-declare const _default: any;
+declare const _default: {
+    cron: string;
+    run(): Promise<void>;
+};
 export default _default;

package/schedules/tracks.d.ts

@@ -1,2 +1,5 @@
-declare const _default: any;
+declare const _default: {
+    cron: string;
+    run(): Promise<void>;
+};
 export default _default;

package/tools/agent_send.d.ts

@@ -1,2 +1,16 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    agent: string;
+    threadId?: string | undefined;
+    input?: string | undefined;
+    policy?: "abort" | "queue" | "steer" | undefined;
+    why?: string | undefined;
+}, any> & {
+    execute(input: {
+        agent: string;
+        threadId?: string | undefined;
+        input?: string | undefined;
+        policy?: "abort" | "queue" | "steer" | undefined;
+        why?: string | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<any>;
+};
 export default _default;

package/tools/apply_tags.d.ts

@@ -1,2 +1,42 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    proposalId?: string | undefined;
+    note?: string | undefined;
+    assignments?: {
+        threadId: string;
+        path?: string | undefined;
+        project?: string | undefined;
+        domain?: string | undefined;
+    }[] | undefined;
+    merges?: {
+        field: "domain";
+        from: string[];
+        to: string;
+    }[] | undefined;
+    labels?: {
+        field: "domain" | "path" | "project";
+        tag: string;
+        label: string | null;
+    }[] | undefined;
+}, any> & {
+    execute(input: {
+        proposalId?: string | undefined;
+        note?: string | undefined;
+        assignments?: {
+            threadId: string;
+            path?: string | undefined;
+            project?: string | undefined;
+            domain?: string | undefined;
+        }[] | undefined;
+        merges?: {
+            field: "domain";
+            from: string[];
+            to: string;
+        }[] | undefined;
+        labels?: {
+            field: "domain" | "path" | "project";
+            tag: string;
+            label: string | null;
+        }[] | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<any>;
+};
 export default _default;

package/tools/archive_thread.d.ts

@@ -1,2 +1,26 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    threadId: string;
+    reason?: string | undefined;
+}, {
+    threadId: string;
+    title: string;
+    archived: {
+        at: string;
+        by: string;
+        reason: string | null;
+    };
+}> & {
+    execute(input: {
+        threadId: string;
+        reason?: string | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        threadId: string;
+        title: string;
+        archived: {
+            at: string;
+            by: string;
+            reason: string | null;
+        };
+    }>;
+};
 export default _default;

package/tools/artifact_list.d.ts

@@ -1,2 +1,28 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    all?: boolean | undefined;
+}, {
+    artifacts: {
+        id: any;
+        version: any;
+        status: any;
+        title: any;
+        alias: any;
+        updatedAt: any;
+        owner?: any;
+    }[];
+}> & {
+    execute(input: {
+        all?: boolean | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        artifacts: {
+            id: any;
+            version: any;
+            status: any;
+            title: any;
+            alias: any;
+            updatedAt: any;
+            owner?: any;
+        }[];
+    }>;
+};
 export default _default;

package/tools/artifact_publish.d.ts

@@ -1,2 +1,18 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    type: string;
+    key: string;
+    source: Record<string, unknown>;
+}, {
+    artifact: any;
+    note: string;
+}> & {
+    execute(input: {
+        type: string;
+        key: string;
+        source: Record<string, unknown>;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        artifact: any;
+        note: string;
+    }>;
+};
 export default _default;

package/tools/artifact_status.d.ts

@@ -1,2 +1,26 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    id: string;
+}, {
+    artifact: {
+        id: any;
+        version: any;
+        status: any;
+        checkedAt: string;
+    };
+    status: any;
+    reasons: any;
+}> & {
+    execute(input: {
+        id: string;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        artifact: {
+            id: any;
+            version: any;
+            status: any;
+            checkedAt: string;
+        };
+        status: any;
+        reasons: any;
+    }>;
+};
 export default _default;

package/tools/attach_image.d.ts

@@ -1,2 +1,16 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    path?: string | undefined;
+    screenshot?: boolean | undefined;
+}, {
+    attachment: any;
+    note: string;
+}> & {
+    execute(input: {
+        path?: string | undefined;
+        screenshot?: boolean | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        attachment: any;
+        note: string;
+    }>;
+};
 export default _default;

package/tools/bash.d.ts

@@ -1,2 +1,17 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    command: string;
+    timeoutSeconds?: number | undefined;
+}, {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+    timedOut?: boolean | undefined;
+    timeoutSeconds?: number | undefined;
+}> & {
+    execute(input: {
+        command: string;
+        timeoutSeconds?: number | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<any>;
+};
 export default _default;

package/tools/browser.d.ts

@@ -1,2 +1,18 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    action: "click" | "open" | "read" | "scroll" | "type";
+    url?: string | undefined;
+    selector?: string | undefined;
+    text?: string | undefined;
+    submit?: boolean | undefined;
+    dy?: number | undefined;
+}, import("../host-browser.js").PageState> & {
+    execute(input: {
+        action: "click" | "open" | "read" | "scroll" | "type";
+        url?: string | undefined;
+        selector?: string | undefined;
+        text?: string | undefined;
+        submit?: boolean | undefined;
+        dy?: number | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<import("../host-browser.js").PageState>;
+};
 export default _default;

package/tools/create_agent.d.ts

@@ -1,2 +1,26 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    name: string;
+    model: string;
+    reasoning?: "high" | "low" | "medium" | "xhigh" | undefined;
+    role: string;
+    instructions?: string | undefined;
+    preset?: "builder" | "read-only" | undefined;
+}, {
+    name: string;
+    port: number;
+    status: string;
+}> & {
+    execute(input: {
+        name: string;
+        model: string;
+        reasoning?: "high" | "low" | "medium" | "xhigh" | undefined;
+        role: string;
+        instructions?: string | undefined;
+        preset?: "builder" | "read-only" | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        name: string;
+        port: number;
+        status: string;
+    }>;
+};
 export default _default;

package/tools/create_thread.d.ts

@@ -1,2 +1,30 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    title: string;
+    message: string;
+    project?: string | undefined;
+    domain?: string | undefined;
+    projectLabel?: string | undefined;
+    domainLabel?: string | undefined;
+    path?: string | undefined;
+    pathLabel?: string | undefined;
+    focus?: boolean | undefined;
+}, {
+    threadId: string;
+    title: string;
+}> & {
+    execute(input: {
+        title: string;
+        message: string;
+        project?: string | undefined;
+        domain?: string | undefined;
+        projectLabel?: string | undefined;
+        domainLabel?: string | undefined;
+        path?: string | undefined;
+        pathLabel?: string | undefined;
+        focus?: boolean | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        threadId: string;
+        title: string;
+    }>;
+};
 export default _default;

package/tools/dash_update.d.ts

@@ -1,2 +1,30 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    entries: {
+        threadId: string;
+        importance?: "high" | "low" | "normal" | undefined;
+        delay?: "blocking" | "fyi" | "land" | undefined;
+        reason?: string | null | undefined;
+        deferred?: boolean | undefined;
+    }[];
+    remove?: string[] | undefined;
+}, {
+    ok: boolean;
+    blocking: number;
+    total: number;
+}> & {
+    execute(input: {
+        entries: {
+            threadId: string;
+            importance?: "high" | "low" | "normal" | undefined;
+            delay?: "blocking" | "fyi" | "land" | undefined;
+            reason?: string | null | undefined;
+            deferred?: boolean | undefined;
+        }[];
+        remove?: string[] | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+        ok: boolean;
+        blocking: number;
+        total: number;
+    }>;
+};
 export default _default;

package/tools/disabled.d.ts

@@ -1,2 +1,2 @@
-declare const _default: any;
+declare const _default: import("eve/tools").DisabledToolSentinel;
 export default _default;

package/tools/list_agents.d.ts

@@ -1,2 +1,60 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<Record<string, never>, {
+    name: string;
+    role: string;
+    model: string;
+    subagentCap: string;
+    subagents: Array<{
+        name: string;
+        model: string;
+        clamped?: string[];
+    }>;
+    agentCopies: {
+        model: string;
+        clamped?: string[];
+    };
+    status: string;
+    busyIn: string[];
+    process?: {
+        status: string;
+        pid: number | null;
+        rssMb?: number;
+        uptimeS?: number;
+        [key: string]: unknown;
+    };
+    restart?: {
+        state: string;
+        recycle?: string;
+        [key: string]: unknown;
+    };
+}[]> & {
+    execute(input: Record<string, never>, ctx: import("eve/tools").ToolContext): Promise<{
+        name: string;
+        role: string;
+        model: string;
+        subagentCap: string;
+        subagents: Array<{
+            name: string;
+            model: string;
+            clamped?: string[];
+        }>;
+        agentCopies: {
+            model: string;
+            clamped?: string[];
+        };
+        status: string;
+        busyIn: string[];
+        process?: {
+            status: string;
+            pid: number | null;
+            rssMb?: number;
+            uptimeS?: number;
+            [key: string]: unknown;
+        };
+        restart?: {
+            state: string;
+            recycle?: string;
+            [key: string]: unknown;
+        };
+    }[]>;
+};
 export default _default;

package/tools/list_threads.d.ts

@@ -1,2 +1,24 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    query?: string | undefined;
+    archived?: "exclude" | "include" | "only" | undefined;
+    kind?: "all" | "dm" | "thread" | undefined;
+    participant?: string | undefined;
+    busy?: string | undefined;
+    project?: string | undefined;
+    path?: string | undefined;
+    domain?: string | undefined;
+    limit?: number | undefined;
+}, any> & {
+    execute(input: {
+        query?: string | undefined;
+        archived?: "exclude" | "include" | "only" | undefined;
+        kind?: "all" | "dm" | "thread" | undefined;
+        participant?: string | undefined;
+        busy?: string | undefined;
+        project?: string | undefined;
+        path?: string | undefined;
+        domain?: string | undefined;
+        limit?: number | undefined;
+    }, ctx: import("eve/tools").ToolContext): Promise<any>;
+};
 export default _default;

package/tools/move_path.d.ts

@@ -1,2 +1,10 @@
-declare const _default: any;
+declare const _default: import("eve/tools").ToolDefinition<{
+    from: string;
+    to: string;
+}, any> & {
+    execute(input: {
+        from: string;
+        to: string;
+    }, ctx: import("eve/tools").ToolContext): Promise<any>;
+};
 export default _default;