@pugi/sdk 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/audit-trace.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { permissionDecisionSchema } from './permission-rules.js';
+import { subagentIsolationSchema, subagentRoleSchema } from './subagent-contracts.js';
 export const auditEventBaseSchema = z.object({
     id: z.string().min(1),
     sessionId: z.string().min(1),
@@ -35,10 +36,150 @@ export const sessionEventSchema = auditEventBaseSchema.extend({
     command: z.string().min(1).optional(),
     status: z.enum(['success', 'error']).optional(),
 });
+const hookEventName = z.enum([
+    'SessionStart',
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PermissionRequest',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'Stop',
+    'SessionEnd',
+]);
+export const hookInvokedEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('hook.invoked'),
+    event: hookEventName,
+    matchSummary: z.string().min(1),
+    runSummary: z.string().min(1),
+});
+export const hookResultEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('hook.result'),
+    event: hookEventName,
+    ok: z.boolean(),
+    exitCode: z.number().int(),
+    elapsedMs: z.number().int().nonnegative(),
+    stdoutLen: z.number().int().nonnegative(),
+    stderrLen: z.number().int().nonnegative(),
+});
+export const hookSkippedEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('hook.skipped'),
+    event: hookEventName,
+    reason: z.enum(['dedup', 'no-match', 'untrusted-project']),
+});
+export const compactionTierSchema = z.enum([
+    'microcompact',
+    'cached_microcompact',
+    'reactive_summary',
+    'session_memory',
+    'full_compaction',
+    'reset',
+]);
+export const compactionStartedEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('compaction.started'),
+    tier: compactionTierSchema,
+    trigger: z.object({
+        budgetUsed: z.number().nonnegative(),
+        budgetMax: z.number().positive(),
+    }),
+});
+export const compactionCompletedEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('compaction.completed'),
+    tier: compactionTierSchema,
+    bytesReclaimed: z.number().nonnegative(),
+    newContextSize: z.number().nonnegative(),
+    artifactsCreated: z.array(z.object({
+        sha256: z.string().min(1),
+        size: z.number().nonnegative(),
+        producedBy: z.string().min(1),
+    })),
+});
+export const compactionSkippedEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('compaction.skipped'),
+    tier: compactionTierSchema,
+    reason: z.string(),
+});
+export const compactionInvariantViolatedEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('compaction.invariant_violated'),
+    invariant: z.enum([
+        'secrets-never-summarize',
+        'open-decisions-preserved',
+        'artifact-refs-resolvable',
+        'static-hash-unchanged',
+    ]),
+    evidence: z.string(),
+    artifactRef: z.string().min(1).optional(),
+});
+/**
+ * Subagent lifecycle events. Extended in Sprint a5.4 (M1 gap remediation D)
+ * so dispatcher activity surfaces in the same `.pugi/events.jsonl` audit
+ * stream as tool calls, hooks, and compactions. The dispatcher
+ * implementation lives in `apps/pugi-cli/src/core/subagents/dispatcher.ts`;
+ * the wire-level shape and role/isolation enums are defined in
+ * `subagent-contracts.ts` and re-used here so a single source of truth
+ * governs validation on both sides of the boundary.
+ */
+export const subagentSpawnedAuditEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('subagent.spawned'),
+    taskId: z.string().min(1),
+    role: subagentRoleSchema,
+    personaSlug: z.string().min(1),
+    parentSessionId: z.string().min(1),
+    isolation: subagentIsolationSchema,
+});
+export const subagentToolCallAuditEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('subagent.tool_call'),
+    taskId: z.string().min(1),
+    role: subagentRoleSchema,
+    personaSlug: z.string().min(1),
+    toolName: z.string().min(1),
+    toolCallId: z.string().min(1),
+});
+export const subagentCompletedAuditEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('subagent.completed'),
+    taskId: z.string().min(1),
+    role: subagentRoleSchema,
+    personaSlug: z.string().min(1),
+    toolCallCount: z.number().int().nonnegative(),
+    tokensIn: z.number().int().nonnegative(),
+    tokensOut: z.number().int().nonnegative(),
+    durationMs: z.number().int().nonnegative(),
+});
+export const subagentBlockedAuditEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('subagent.blocked'),
+    taskId: z.string().min(1),
+    role: subagentRoleSchema,
+    personaSlug: z.string().min(1),
+    reason: z.enum([
+        'budget_exhausted',
+        'plan_mode_refused',
+        'permission_denied',
+        'tool_unavailable',
+    ]),
+    detail: z.string().min(1),
+});
+export const subagentFailedAuditEventSchema = auditEventBaseSchema.extend({
+    type: z.literal('subagent.failed'),
+    taskId: z.string().min(1),
+    role: subagentRoleSchema,
+    personaSlug: z.string().min(1),
+    error: z.string().min(1),
+});
 export const auditEventSchema = z.discriminatedUnion('type', [
     sessionEventSchema,
     toolCallEventSchema,
     toolResultEventSchema,
     fileMutationEventSchema,
+    hookInvokedEventSchema,
+    hookResultEventSchema,
+    hookSkippedEventSchema,
+    compactionStartedEventSchema,
+    compactionCompletedEventSchema,
+    compactionSkippedEventSchema,
+    compactionInvariantViolatedEventSchema,
+    subagentSpawnedAuditEventSchema,
+    subagentToolCallAuditEventSchema,
+    subagentCompletedAuditEventSchema,
+    subagentBlockedAuditEventSchema,
+    subagentFailedAuditEventSchema,
 ]);
 //# sourceMappingURL=audit-trace.js.map

package/dist/index.d.ts

@@ -6,5 +6,6 @@ export * from './engine-loop.js';
 export * from './handoff.js';
 export * from './mcp-schemas.js';
 export * from './permission-rules.js';
+export * from './subagent-contracts.js';
 export * from './transport.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -6,5 +6,6 @@ export * from './engine-loop.js';
 export * from './handoff.js';
 export * from './mcp-schemas.js';
 export * from './permission-rules.js';
+export * from './subagent-contracts.js';
 export * from './transport.js';
 //# sourceMappingURL=index.js.map