@pugi/sdk 0.1.0-alpha.3

package/dist/handoff.d.ts

@@ -0,0 +1,605 @@
+import { z } from 'zod';
+export declare const pugiSyncPrivacyModeSchema: z.ZodEnum<["local-only", "metadata", "summaries", "selected-files", "full-sync"]>;
+export type PugiSyncPrivacyMode = z.infer<typeof pugiSyncPrivacyModeSchema>;
+export declare const pugiWorkspaceSnapshotSchema: z.ZodObject<{
+    rootName: z.ZodString;
+    gitBranch: z.ZodNullable<z.ZodString>;
+    gitHead: z.ZodNullable<z.ZodString>;
+    dirty: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    dirty: boolean;
+    rootName: string;
+    gitBranch: string | null;
+    gitHead: string | null;
+}, {
+    dirty: boolean;
+    rootName: string;
+    gitBranch: string | null;
+    gitHead: string | null;
+}>;
+export declare const pugiHandoffBundleSchema: z.ZodObject<{
+    schema: z.ZodLiteral<1>;
+    id: z.ZodString;
+    reason: z.ZodString;
+    prompt: z.ZodString;
+    createdAt: z.ZodString;
+    workspace: z.ZodObject<{
+        rootName: z.ZodString;
+        gitBranch: z.ZodNullable<z.ZodString>;
+        gitHead: z.ZodNullable<z.ZodString>;
+        dirty: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    }, {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    }>;
+    session: z.ZodObject<{
+        id: z.ZodString;
+        eventsPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        eventsPath: string;
+    }, {
+        id: string;
+        eventsPath: string;
+    }>;
+    artifacts: z.ZodObject<{
+        latest: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        latest: string | null;
+    }, {
+        latest: string | null;
+    }>;
+    privacy: z.ZodObject<{
+        includesFileContents: z.ZodBoolean;
+        includesSecrets: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        includesFileContents: boolean;
+        includesSecrets: boolean;
+    }, {
+        includesFileContents: boolean;
+        includesSecrets: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    reason: string;
+    createdAt: string;
+    prompt: string;
+    artifacts: {
+        latest: string | null;
+    };
+    session: {
+        id: string;
+        eventsPath: string;
+    };
+    schema: 1;
+    workspace: {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    };
+    privacy: {
+        includesFileContents: boolean;
+        includesSecrets: boolean;
+    };
+}, {
+    id: string;
+    reason: string;
+    createdAt: string;
+    prompt: string;
+    artifacts: {
+        latest: string | null;
+    };
+    session: {
+        id: string;
+        eventsPath: string;
+    };
+    schema: 1;
+    workspace: {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    };
+    privacy: {
+        includesFileContents: boolean;
+        includesSecrets: boolean;
+    };
+}>;
+export type PugiHandoffBundle = z.infer<typeof pugiHandoffBundleSchema>;
+export declare const pugiSyncDryRunItemSchema: z.ZodObject<{
+    kind: z.ZodEnum<["artifact_metadata", "artifact_summary", "handoff_bundle", "session_event_log"]>;
+    path: z.ZodString;
+    bytes: z.ZodNumber;
+    action: z.ZodEnum<["include", "exclude"]>;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    reason: string;
+    kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+    bytes: number;
+    action: "include" | "exclude";
+}, {
+    path: string;
+    reason: string;
+    kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+    bytes: number;
+    action: "include" | "exclude";
+}>;
+export type PugiSyncDryRunItem = z.infer<typeof pugiSyncDryRunItemSchema>;
+export declare const pugiSyncDryRunPlanSchema: z.ZodObject<{
+    schema: z.ZodLiteral<1>;
+    createdAt: z.ZodString;
+    mode: z.ZodEnum<["local-only", "metadata", "summaries", "selected-files", "full-sync"]>;
+    uploadEnabled: z.ZodLiteral<false>;
+    workspace: z.ZodObject<{
+        rootName: z.ZodString;
+        gitBranch: z.ZodNullable<z.ZodString>;
+        gitHead: z.ZodNullable<z.ZodString>;
+        dirty: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    }, {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    }>;
+    items: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["artifact_metadata", "artifact_summary", "handoff_bundle", "session_event_log"]>;
+        path: z.ZodString;
+        bytes: z.ZodNumber;
+        action: z.ZodEnum<["include", "exclude"]>;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }, {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }>, "many">;
+    exclusions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    notes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+    schema: 1;
+    workspace: {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    };
+    uploadEnabled: false;
+    items: {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }[];
+    exclusions: string[];
+    notes: string[];
+}, {
+    createdAt: string;
+    mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+    schema: 1;
+    workspace: {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    };
+    uploadEnabled: false;
+    items: {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }[];
+    exclusions?: string[] | undefined;
+    notes?: string[] | undefined;
+}>;
+export type PugiSyncDryRunPlan = z.infer<typeof pugiSyncDryRunPlanSchema>;
+export declare const pugiSyncUploadPlanSchema: z.ZodObject<Omit<{
+    schema: z.ZodLiteral<1>;
+    createdAt: z.ZodString;
+    mode: z.ZodEnum<["local-only", "metadata", "summaries", "selected-files", "full-sync"]>;
+    uploadEnabled: z.ZodLiteral<false>;
+    workspace: z.ZodObject<{
+        rootName: z.ZodString;
+        gitBranch: z.ZodNullable<z.ZodString>;
+        gitHead: z.ZodNullable<z.ZodString>;
+        dirty: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    }, {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    }>;
+    items: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["artifact_metadata", "artifact_summary", "handoff_bundle", "session_event_log"]>;
+        path: z.ZodString;
+        bytes: z.ZodNumber;
+        action: z.ZodEnum<["include", "exclude"]>;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }, {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }>, "many">;
+    exclusions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    notes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "uploadEnabled"> & {
+    uploadEnabled: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+    schema: 1;
+    workspace: {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    };
+    uploadEnabled: true;
+    items: {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }[];
+    exclusions: string[];
+    notes: string[];
+}, {
+    createdAt: string;
+    mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+    schema: 1;
+    workspace: {
+        dirty: boolean;
+        rootName: string;
+        gitBranch: string | null;
+        gitHead: string | null;
+    };
+    uploadEnabled: true;
+    items: {
+        path: string;
+        reason: string;
+        kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+        bytes: number;
+        action: "include" | "exclude";
+    }[];
+    exclusions?: string[] | undefined;
+    notes?: string[] | undefined;
+}>;
+export type PugiSyncUploadPlan = z.infer<typeof pugiSyncUploadPlanSchema>;
+export declare const pugiSyncRequestSchema: z.ZodObject<{
+    schema: z.ZodLiteral<1>;
+    bundle: z.ZodObject<{
+        schema: z.ZodLiteral<1>;
+        id: z.ZodString;
+        reason: z.ZodString;
+        prompt: z.ZodString;
+        createdAt: z.ZodString;
+        workspace: z.ZodObject<{
+            rootName: z.ZodString;
+            gitBranch: z.ZodNullable<z.ZodString>;
+            gitHead: z.ZodNullable<z.ZodString>;
+            dirty: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        }, {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        }>;
+        session: z.ZodObject<{
+            id: z.ZodString;
+            eventsPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            eventsPath: string;
+        }, {
+            id: string;
+            eventsPath: string;
+        }>;
+        artifacts: z.ZodObject<{
+            latest: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            latest: string | null;
+        }, {
+            latest: string | null;
+        }>;
+        privacy: z.ZodObject<{
+            includesFileContents: z.ZodBoolean;
+            includesSecrets: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            includesFileContents: boolean;
+            includesSecrets: boolean;
+        }, {
+            includesFileContents: boolean;
+            includesSecrets: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        reason: string;
+        createdAt: string;
+        prompt: string;
+        artifacts: {
+            latest: string | null;
+        };
+        session: {
+            id: string;
+            eventsPath: string;
+        };
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        privacy: {
+            includesFileContents: boolean;
+            includesSecrets: boolean;
+        };
+    }, {
+        id: string;
+        reason: string;
+        createdAt: string;
+        prompt: string;
+        artifacts: {
+            latest: string | null;
+        };
+        session: {
+            id: string;
+            eventsPath: string;
+        };
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        privacy: {
+            includesFileContents: boolean;
+            includesSecrets: boolean;
+        };
+    }>;
+    plan: z.ZodObject<Omit<{
+        schema: z.ZodLiteral<1>;
+        createdAt: z.ZodString;
+        mode: z.ZodEnum<["local-only", "metadata", "summaries", "selected-files", "full-sync"]>;
+        uploadEnabled: z.ZodLiteral<false>;
+        workspace: z.ZodObject<{
+            rootName: z.ZodString;
+            gitBranch: z.ZodNullable<z.ZodString>;
+            gitHead: z.ZodNullable<z.ZodString>;
+            dirty: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        }, {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        }>;
+        items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["artifact_metadata", "artifact_summary", "handoff_bundle", "session_event_log"]>;
+            path: z.ZodString;
+            bytes: z.ZodNumber;
+            action: z.ZodEnum<["include", "exclude"]>;
+            reason: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            reason: string;
+            kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+            bytes: number;
+            action: "include" | "exclude";
+        }, {
+            path: string;
+            reason: string;
+            kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+            bytes: number;
+            action: "include" | "exclude";
+        }>, "many">;
+        exclusions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "uploadEnabled"> & {
+        uploadEnabled: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        uploadEnabled: true;
+        items: {
+            path: string;
+            reason: string;
+            kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+            bytes: number;
+            action: "include" | "exclude";
+        }[];
+        exclusions: string[];
+        notes: string[];
+    }, {
+        createdAt: string;
+        mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        uploadEnabled: true;
+        items: {
+            path: string;
+            reason: string;
+            kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+            bytes: number;
+            action: "include" | "exclude";
+        }[];
+        exclusions?: string[] | undefined;
+        notes?: string[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    plan: {
+        createdAt: string;
+        mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        uploadEnabled: true;
+        items: {
+            path: string;
+            reason: string;
+            kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+            bytes: number;
+            action: "include" | "exclude";
+        }[];
+        exclusions: string[];
+        notes: string[];
+    };
+    schema: 1;
+    bundle: {
+        id: string;
+        reason: string;
+        createdAt: string;
+        prompt: string;
+        artifacts: {
+            latest: string | null;
+        };
+        session: {
+            id: string;
+            eventsPath: string;
+        };
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        privacy: {
+            includesFileContents: boolean;
+            includesSecrets: boolean;
+        };
+    };
+}, {
+    plan: {
+        createdAt: string;
+        mode: "local-only" | "metadata" | "summaries" | "selected-files" | "full-sync";
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        uploadEnabled: true;
+        items: {
+            path: string;
+            reason: string;
+            kind: "artifact_metadata" | "artifact_summary" | "handoff_bundle" | "session_event_log";
+            bytes: number;
+            action: "include" | "exclude";
+        }[];
+        exclusions?: string[] | undefined;
+        notes?: string[] | undefined;
+    };
+    schema: 1;
+    bundle: {
+        id: string;
+        reason: string;
+        createdAt: string;
+        prompt: string;
+        artifacts: {
+            latest: string | null;
+        };
+        session: {
+            id: string;
+            eventsPath: string;
+        };
+        schema: 1;
+        workspace: {
+            dirty: boolean;
+            rootName: string;
+            gitBranch: string | null;
+            gitHead: string | null;
+        };
+        privacy: {
+            includesFileContents: boolean;
+            includesSecrets: boolean;
+        };
+    };
+}>;
+export type PugiSyncRequest = z.infer<typeof pugiSyncRequestSchema>;
+export declare const pugiSyncStatusSchema: z.ZodEnum<["received", "queued", "processing", "done", "failed"]>;
+export type PugiSyncStatus = z.infer<typeof pugiSyncStatusSchema>;
+export declare const pugiSyncResponseSchema: z.ZodObject<{
+    schema: z.ZodLiteral<1>;
+    syncId: z.ZodString;
+    status: z.ZodEnum<["received", "queued", "processing", "done", "failed"]>;
+    receivedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "received" | "failed" | "done" | "queued" | "processing";
+    schema: 1;
+    syncId: string;
+    receivedAt: string;
+}, {
+    status: "received" | "failed" | "done" | "queued" | "processing";
+    schema: 1;
+    syncId: string;
+    receivedAt: string;
+}>;
+export type PugiSyncResponse = z.infer<typeof pugiSyncResponseSchema>;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export const pugiSyncPrivacyModeSchema = z.enum([
+    'local-only',
+    'metadata',
+    'summaries',
+    'selected-files',
+    'full-sync',
+]);
+export const pugiWorkspaceSnapshotSchema = z.object({
+    rootName: z.string().min(1),
+    gitBranch: z.string().min(1).nullable(),
+    gitHead: z.string().min(1).nullable(),
+    dirty: z.boolean(),
+});
+export const pugiHandoffBundleSchema = z.object({
+    schema: z.literal(1),
+    id: z.string().min(1),
+    reason: z.string().min(1),
+    prompt: z.string().min(1),
+    createdAt: z.string().datetime(),
+    workspace: pugiWorkspaceSnapshotSchema,
+    session: z.object({
+        id: z.string().min(1),
+        eventsPath: z.string().min(1),
+    }),
+    artifacts: z.object({
+        latest: z.string().min(1).nullable(),
+    }),
+    privacy: z.object({
+        includesFileContents: z.boolean(),
+        includesSecrets: z.boolean(),
+    }),
+});
+export const pugiSyncDryRunItemSchema = z.object({
+    kind: z.enum(['artifact_metadata', 'artifact_summary', 'handoff_bundle', 'session_event_log']),
+    path: z.string().min(1),
+    bytes: z.number().int().nonnegative(),
+    action: z.enum(['include', 'exclude']),
+    reason: z.string().min(1),
+});
+export const pugiSyncDryRunPlanSchema = z.object({
+    schema: z.literal(1),
+    createdAt: z.string().datetime(),
+    mode: pugiSyncPrivacyModeSchema,
+    uploadEnabled: z.literal(false),
+    workspace: pugiWorkspaceSnapshotSchema,
+    items: z.array(pugiSyncDryRunItemSchema),
+    exclusions: z.array(z.string()).default([]),
+    notes: z.array(z.string()).default([]),
+});
+// Mirror of pugiSyncDryRunPlanSchema with the `uploadEnabled` literal
+// flipped to `true`. The CLI builds the dry-run plan first, surfaces
+// it to the operator, and — only when `--dry-run` is absent — converts
+// to this upload-enabled shape before POSTing.
+export const pugiSyncUploadPlanSchema = pugiSyncDryRunPlanSchema
+    .omit({ uploadEnabled: true })
+    .extend({ uploadEnabled: z.literal(true) });
+export const pugiSyncRequestSchema = z.object({
+    schema: z.literal(1),
+    bundle: pugiHandoffBundleSchema,
+    plan: pugiSyncUploadPlanSchema,
+});
+export const pugiSyncStatusSchema = z.enum([
+    'received',
+    'queued',
+    'processing',
+    'done',
+    'failed',
+]);
+export const pugiSyncResponseSchema = z.object({
+    schema: z.literal(1),
+    syncId: z.string().min(1),
+    status: pugiSyncStatusSchema,
+    receivedAt: z.string().datetime(),
+});
+//# sourceMappingURL=handoff.js.map

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './agent-contracts.js';
+export * from './audit-trace.js';
+export * from './device-flow.js';
+export * from './engine-adapter.js';
+export * from './engine-loop.js';
+export * from './handoff.js';
+export * from './mcp-schemas.js';
+export * from './permission-rules.js';
+export * from './transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './agent-contracts.js';
+export * from './audit-trace.js';
+export * from './device-flow.js';
+export * from './engine-adapter.js';
+export * from './engine-loop.js';
+export * from './handoff.js';
+export * from './mcp-schemas.js';
+export * from './permission-rules.js';
+export * from './transport.js';
+//# sourceMappingURL=index.js.map