@kmmao/happy-wire 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -114,7 +114,9 @@ const sessionTaskStartEventSchema = z__namespace.object({
   taskId: z__namespace.string(),
   toolUseId: z__namespace.string().optional(),
   description: z__namespace.string(),
-  taskType: z__namespace.string().optional()
+  taskType: z__namespace.string().optional(),
+  /** meta.name from the workflow script (e.g. 'spec'). Only set when taskType is 'local_workflow'. */
+  workflowName: z__namespace.string().optional()
 });
 const sessionTaskProgressEventSchema = z__namespace.object({
   t: z__namespace.literal("task-progress"),
@@ -154,6 +156,11 @@ const sessionPromptSuggestionEventSchema = z__namespace.object({
 const sessionNeedsContinueEventSchema = z__namespace.object({
   t: z__namespace.literal("needs-continue")
 });
+const sessionStateChangedEventSchema = z__namespace.object({
+  t: z__namespace.literal("session-state-changed"),
+  /** Authoritative session lifecycle state from the SDK */
+  state: z__namespace.enum(["idle", "running", "requires_action"])
+});
 const sessionEventSchema = z__namespace.discriminatedUnion("t", [
   sessionTextEventSchema,
   sessionServiceMessageEventSchema,
@@ -170,7 +177,8 @@ const sessionEventSchema = z__namespace.discriminatedUnion("t", [
   sessionTaskEndEventSchema,
   sessionToolProgressEventSchema,
   sessionPromptSuggestionEventSchema,
-  sessionNeedsContinueEventSchema
+  sessionNeedsContinueEventSchema,
+  sessionStateChangedEventSchema
 ]);
 const sessionEnvelopeSchema = z__namespace.object({
   id: z__namespace.string(),
@@ -189,7 +197,7 @@ const sessionEnvelopeSchema = z__namespace.object({
       path: ["role"]
     });
   }
-  if ((envelope.ev.t === "start" || envelope.ev.t === "stop" || envelope.ev.t === "usage-update" || envelope.ev.t === "task-start" || envelope.ev.t === "task-progress" || envelope.ev.t === "task-end" || envelope.ev.t === "tool-progress" || envelope.ev.t === "prompt-suggestion" || envelope.ev.t === "needs-continue") && envelope.role !== "agent") {
+  if ((envelope.ev.t === "start" || envelope.ev.t === "stop" || envelope.ev.t === "usage-update" || envelope.ev.t === "task-start" || envelope.ev.t === "task-progress" || envelope.ev.t === "task-end" || envelope.ev.t === "tool-progress" || envelope.ev.t === "prompt-suggestion" || envelope.ev.t === "needs-continue" || envelope.ev.t === "session-state-changed") && envelope.role !== "agent") {
     ctx.addIssue({
       code: z__namespace.ZodIssueCode.custom,
       message: `${envelope.ev.t} events must use role "agent"`,
@@ -387,6 +395,129 @@ const DaemonStateSchema = z__namespace.object({
   tunnels: TunnelStateSchema.optional()
 });
 
+const KnowledgeEntryTypeSchema = z__namespace.enum([
+  "discovery",
+  // New insight or finding
+  "decision",
+  // Architecture / tech choice
+  "fix",
+  // Bug fix record
+  "convention",
+  // Code convention / process rule
+  "warning"
+  // Known pitfall or gotcha
+]);
+const KnowledgeContributorTypeSchema = z__namespace.enum([
+  "session",
+  // Auto-generated by Claude session
+  "supervisor",
+  // Generated by Supervisor analysis
+  "user"
+  // Manually added by user
+]);
+const KnowledgeActionSchema = z__namespace.enum([
+  "create",
+  // New entry
+  "amend",
+  // Correction / supplement
+  "supersede",
+  // Replace old knowledge
+  "verify"
+  // Confirm still valid
+]);
+const KnowledgeStatusSchema = z__namespace.enum([
+  "active",
+  // Currently valid
+  "superseded",
+  // Replaced by newer knowledge
+  "archived"
+  // Manually archived by user
+]);
+const KnowledgeConfidenceSchema = z__namespace.enum(["high", "medium", "low"]);
+const CreateKnowledgeEntryBodySchema = z__namespace.object({
+  entryType: KnowledgeEntryTypeSchema,
+  contributorType: KnowledgeContributorTypeSchema,
+  action: KnowledgeActionSchema,
+  title: z__namespace.string().min(1).max(200),
+  content: z__namespace.string().min(1),
+  // Structured SOAP-like fields (optional)
+  request: z__namespace.string().optional(),
+  // S: What the user asked
+  findings: z__namespace.string().optional(),
+  // O: What was discovered
+  analysis: z__namespace.string().optional(),
+  // A: Root cause / assessment
+  outcome: z__namespace.string().optional(),
+  // P: What was done
+  nextSteps: z__namespace.string().optional(),
+  // Follow-up suggestions
+  tags: z__namespace.array(z__namespace.string().max(50)).max(20).default([]),
+  confidence: KnowledgeConfidenceSchema.default("medium"),
+  sessionId: z__namespace.string().optional(),
+  model: z__namespace.string().optional(),
+  supersedesId: z__namespace.string().optional(),
+  relatedIds: z__namespace.array(z__namespace.string()).max(10).default([]),
+  affectedFiles: z__namespace.array(z__namespace.string()).max(50).default([])
+});
+const UpdateKnowledgeEntryBodySchema = z__namespace.object({
+  status: KnowledgeStatusSchema.optional(),
+  pinned: z__namespace.boolean().optional(),
+  title: z__namespace.string().min(1).max(200).optional(),
+  content: z__namespace.string().min(1).optional(),
+  tags: z__namespace.array(z__namespace.string().max(50)).max(20).optional(),
+  confidence: KnowledgeConfidenceSchema.optional()
+});
+const QueryKnowledgeParamsSchema = z__namespace.object({
+  entryType: KnowledgeEntryTypeSchema.optional(),
+  status: KnowledgeStatusSchema.optional(),
+  tags: z__namespace.array(z__namespace.string()).optional(),
+  search: z__namespace.string().optional(),
+  limit: z__namespace.number().int().min(1).max(100).default(20),
+  offset: z__namespace.number().int().min(0).default(0)
+});
+const ProjectProfileSchema = z__namespace.object({
+  techStack: z__namespace.array(z__namespace.string()),
+  architectureType: z__namespace.string().optional(),
+  knownPitfalls: z__namespace.array(z__namespace.string()),
+  coreConventions: z__namespace.array(z__namespace.string()),
+  lastUpdatedAt: z__namespace.number(),
+  lastUpdatedBy: z__namespace.string().optional()
+});
+const KnowledgeInjectionModeSchema = z__namespace.enum(["auto", "full", "minimal"]);
+const KnowledgeInjectionRequestSchema = z__namespace.object({
+  mode: KnowledgeInjectionModeSchema,
+  contextHints: z__namespace.array(z__namespace.string()).optional()
+  // Keywords from user message for relevance
+});
+const KnowledgeInjectionResponseSchema = z__namespace.object({
+  profile: ProjectProfileSchema.nullable(),
+  entries: z__namespace.array(z__namespace.object({
+    id: z__namespace.string(),
+    entryType: KnowledgeEntryTypeSchema,
+    title: z__namespace.string(),
+    content: z__namespace.string(),
+    tags: z__namespace.array(z__namespace.string()),
+    confidence: KnowledgeConfidenceSchema,
+    createdAt: z__namespace.string()
+  }))
+});
+const TurnKnowledgeExtractionSchema = z__namespace.object({
+  projectId: z__namespace.string(),
+  sessionId: z__namespace.string(),
+  model: z__namespace.string(),
+  turnId: z__namespace.string(),
+  turnData: z__namespace.object({
+    userMessage: z__namespace.string().max(2e3),
+    assistantText: z__namespace.string().max(5e3),
+    fileEdits: z__namespace.array(z__namespace.object({
+      path: z__namespace.string(),
+      type: z__namespace.enum(["create", "edit"])
+    })).max(50),
+    toolCallCount: z__namespace.number().int(),
+    outputTokens: z__namespace.number().int()
+  })
+});
+
 exports.AgentMessageSchema = AgentMessageSchema;
 exports.ApiMessageSchema = ApiMessageSchema;
 exports.ApiUpdateMachineStateSchema = ApiUpdateMachineStateSchema;
@@ -394,11 +525,22 @@ exports.ApiUpdateNewMessageSchema = ApiUpdateNewMessageSchema;
 exports.ApiUpdateSessionStateSchema = ApiUpdateSessionStateSchema;
 exports.CoreUpdateBodySchema = CoreUpdateBodySchema;
 exports.CoreUpdateContainerSchema = CoreUpdateContainerSchema;
+exports.CreateKnowledgeEntryBodySchema = CreateKnowledgeEntryBodySchema;
 exports.DaemonStateSchema = DaemonStateSchema;
+exports.KnowledgeActionSchema = KnowledgeActionSchema;
+exports.KnowledgeConfidenceSchema = KnowledgeConfidenceSchema;
+exports.KnowledgeContributorTypeSchema = KnowledgeContributorTypeSchema;
+exports.KnowledgeEntryTypeSchema = KnowledgeEntryTypeSchema;
+exports.KnowledgeInjectionModeSchema = KnowledgeInjectionModeSchema;
+exports.KnowledgeInjectionRequestSchema = KnowledgeInjectionRequestSchema;
+exports.KnowledgeInjectionResponseSchema = KnowledgeInjectionResponseSchema;
+exports.KnowledgeStatusSchema = KnowledgeStatusSchema;
 exports.LegacyMessageContentSchema = LegacyMessageContentSchema;
 exports.MachineMetadataSchema = MachineMetadataSchema;
 exports.MessageContentSchema = MessageContentSchema;
 exports.MessageMetaSchema = MessageMetaSchema;
+exports.ProjectProfileSchema = ProjectProfileSchema;
+exports.QueryKnowledgeParamsSchema = QueryKnowledgeParamsSchema;
 exports.SessionMessageContentSchema = SessionMessageContentSchema;
 exports.SessionMessageSchema = SessionMessageSchema;
 exports.SessionProtocolMessageSchema = SessionProtocolMessageSchema;
@@ -407,7 +549,9 @@ exports.TailscaleServeEntrySchema = TailscaleServeEntrySchema;
 exports.TunnelEntrySchema = TunnelEntrySchema;
 exports.TunnelProviderInfoSchema = TunnelProviderInfoSchema;
 exports.TunnelStateSchema = TunnelStateSchema;
+exports.TurnKnowledgeExtractionSchema = TurnKnowledgeExtractionSchema;
 exports.UpdateBodySchema = UpdateBodySchema;
+exports.UpdateKnowledgeEntryBodySchema = UpdateKnowledgeEntryBodySchema;
 exports.UpdateMachineBodySchema = UpdateMachineBodySchema;
 exports.UpdateNewMessageBodySchema = UpdateNewMessageBodySchema;
 exports.UpdateSchema = UpdateSchema;
@@ -426,6 +570,7 @@ exports.sessionPromptSuggestionEventSchema = sessionPromptSuggestionEventSchema;
 exports.sessionRoleSchema = sessionRoleSchema;
 exports.sessionServiceMessageEventSchema = sessionServiceMessageEventSchema;
 exports.sessionStartEventSchema = sessionStartEventSchema;
+exports.sessionStateChangedEventSchema = sessionStateChangedEventSchema;
 exports.sessionStopEventSchema = sessionStopEventSchema;
 exports.sessionTaskEndEventSchema = sessionTaskEndEventSchema;
 exports.sessionTaskProgressEventSchema = sessionTaskProgressEventSchema;

package/dist/index.d.cts

@@ -128,6 +128,7 @@ declare const SessionProtocolMessageSchema: z.ZodObject<{
             toolUseId: z.ZodOptional<z.ZodString>;
             description: z.ZodString;
             taskType: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"task-progress">;
             taskId: z.ZodString;
@@ -164,6 +165,13 @@ declare const SessionProtocolMessageSchema: z.ZodObject<{
             suggestion: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"needs-continue">;
+        }, z.core.$strip>, z.ZodObject<{
+            t: z.ZodLiteral<"session-state-changed">;
+            state: z.ZodEnum<{
+                idle: "idle";
+                running: "running";
+                requires_action: "requires_action";
+            }>;
         }, z.core.$strip>], "t">;
     }, z.core.$strip>;
     meta: z.ZodOptional<z.ZodObject<{
@@ -326,6 +334,7 @@ declare const MessageContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             toolUseId: z.ZodOptional<z.ZodString>;
             description: z.ZodString;
             taskType: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"task-progress">;
             taskId: z.ZodString;
@@ -362,6 +371,13 @@ declare const MessageContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             suggestion: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"needs-continue">;
+        }, z.core.$strip>, z.ZodObject<{
+            t: z.ZodLiteral<"session-state-changed">;
+            state: z.ZodEnum<{
+                idle: "idle";
+                running: "running";
+                requires_action: "requires_action";
+            }>;
         }, z.core.$strip>], "t">;
     }, z.core.$strip>;
     meta: z.ZodOptional<z.ZodObject<{
@@ -883,6 +899,7 @@ declare const sessionTaskStartEventSchema: z.ZodObject<{
     toolUseId: z.ZodOptional<z.ZodString>;
     description: z.ZodString;
     taskType: z.ZodOptional<z.ZodString>;
+    workflowName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const sessionTaskProgressEventSchema: z.ZodObject<{
     t: z.ZodLiteral<"task-progress">;
@@ -925,6 +942,14 @@ declare const sessionPromptSuggestionEventSchema: z.ZodObject<{
 declare const sessionNeedsContinueEventSchema: z.ZodObject<{
     t: z.ZodLiteral<"needs-continue">;
 }, z.core.$strip>;
+declare const sessionStateChangedEventSchema: z.ZodObject<{
+    t: z.ZodLiteral<"session-state-changed">;
+    state: z.ZodEnum<{
+        idle: "idle";
+        running: "running";
+        requires_action: "requires_action";
+    }>;
+}, z.core.$strip>;
 declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     t: z.ZodLiteral<"text">;
     text: z.ZodString;
@@ -1003,6 +1028,7 @@ declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     toolUseId: z.ZodOptional<z.ZodString>;
     description: z.ZodString;
     taskType: z.ZodOptional<z.ZodString>;
+    workflowName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"task-progress">;
     taskId: z.ZodString;
@@ -1039,6 +1065,13 @@ declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     suggestion: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"needs-continue">;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"session-state-changed">;
+    state: z.ZodEnum<{
+        idle: "idle";
+        running: "running";
+        requires_action: "requires_action";
+    }>;
 }, z.core.$strip>], "t">;
 type SessionEvent = z.infer<typeof sessionEventSchema>;
 declare const sessionEnvelopeSchema: z.ZodObject<{
@@ -1128,6 +1161,7 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
         toolUseId: z.ZodOptional<z.ZodString>;
         description: z.ZodString;
         taskType: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         t: z.ZodLiteral<"task-progress">;
         taskId: z.ZodString;
@@ -1164,6 +1198,13 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
         suggestion: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         t: z.ZodLiteral<"needs-continue">;
+    }, z.core.$strip>, z.ZodObject<{
+        t: z.ZodLiteral<"session-state-changed">;
+        state: z.ZodEnum<{
+            idle: "idle";
+            running: "running";
+            requires_action: "requires_action";
+        }>;
     }, z.core.$strip>], "t">;
 }, z.core.$strip>;
 type SessionEnvelope = z.infer<typeof sessionEnvelopeSchema>;
@@ -1360,5 +1401,188 @@ declare const DaemonStateSchema: z.ZodObject<{
 }, z.core.$strip>;
 type DaemonState = z.infer<typeof DaemonStateSchema>;
 
-export { AgentMessageSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, DaemonStateSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, UpdateBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, createEnvelope, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStopEventSchema, sessionTaskEndEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema };
-export type { AgentMessage, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, DaemonState, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, SessionEnvelope, SessionEvent, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProtocolMessage, SessionRole, SessionTurnEndStatus, TailscaleInfo, TailscaleServeEntry, TunnelEntry, TunnelProviderInfo, TunnelState, Update, UpdateBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue };
+declare const KnowledgeEntryTypeSchema: z.ZodEnum<{
+    discovery: "discovery";
+    decision: "decision";
+    fix: "fix";
+    convention: "convention";
+    warning: "warning";
+}>;
+type KnowledgeEntryType = z.infer<typeof KnowledgeEntryTypeSchema>;
+declare const KnowledgeContributorTypeSchema: z.ZodEnum<{
+    user: "user";
+    session: "session";
+    supervisor: "supervisor";
+}>;
+type KnowledgeContributorType = z.infer<typeof KnowledgeContributorTypeSchema>;
+declare const KnowledgeActionSchema: z.ZodEnum<{
+    create: "create";
+    amend: "amend";
+    supersede: "supersede";
+    verify: "verify";
+}>;
+type KnowledgeAction = z.infer<typeof KnowledgeActionSchema>;
+declare const KnowledgeStatusSchema: z.ZodEnum<{
+    active: "active";
+    superseded: "superseded";
+    archived: "archived";
+}>;
+type KnowledgeStatus = z.infer<typeof KnowledgeStatusSchema>;
+declare const KnowledgeConfidenceSchema: z.ZodEnum<{
+    high: "high";
+    medium: "medium";
+    low: "low";
+}>;
+type KnowledgeConfidence = z.infer<typeof KnowledgeConfidenceSchema>;
+declare const CreateKnowledgeEntryBodySchema: z.ZodObject<{
+    entryType: z.ZodEnum<{
+        discovery: "discovery";
+        decision: "decision";
+        fix: "fix";
+        convention: "convention";
+        warning: "warning";
+    }>;
+    contributorType: z.ZodEnum<{
+        user: "user";
+        session: "session";
+        supervisor: "supervisor";
+    }>;
+    action: z.ZodEnum<{
+        create: "create";
+        amend: "amend";
+        supersede: "supersede";
+        verify: "verify";
+    }>;
+    title: z.ZodString;
+    content: z.ZodString;
+    request: z.ZodOptional<z.ZodString>;
+    findings: z.ZodOptional<z.ZodString>;
+    analysis: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodOptional<z.ZodString>;
+    nextSteps: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    confidence: z.ZodDefault<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    supersedesId: z.ZodOptional<z.ZodString>;
+    relatedIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    affectedFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type CreateKnowledgeEntryBody = z.infer<typeof CreateKnowledgeEntryBodySchema>;
+declare const UpdateKnowledgeEntryBodySchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        superseded: "superseded";
+        archived: "archived";
+    }>>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    confidence: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+}, z.core.$strip>;
+type UpdateKnowledgeEntryBody = z.infer<typeof UpdateKnowledgeEntryBodySchema>;
+declare const QueryKnowledgeParamsSchema: z.ZodObject<{
+    entryType: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        decision: "decision";
+        fix: "fix";
+        convention: "convention";
+        warning: "warning";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        superseded: "superseded";
+        archived: "archived";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type QueryKnowledgeParams = z.infer<typeof QueryKnowledgeParamsSchema>;
+declare const ProjectProfileSchema: z.ZodObject<{
+    techStack: z.ZodArray<z.ZodString>;
+    architectureType: z.ZodOptional<z.ZodString>;
+    knownPitfalls: z.ZodArray<z.ZodString>;
+    coreConventions: z.ZodArray<z.ZodString>;
+    lastUpdatedAt: z.ZodNumber;
+    lastUpdatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ProjectProfile = z.infer<typeof ProjectProfileSchema>;
+declare const KnowledgeInjectionModeSchema: z.ZodEnum<{
+    auto: "auto";
+    full: "full";
+    minimal: "minimal";
+}>;
+type KnowledgeInjectionMode = z.infer<typeof KnowledgeInjectionModeSchema>;
+declare const KnowledgeInjectionRequestSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        auto: "auto";
+        full: "full";
+        minimal: "minimal";
+    }>;
+    contextHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type KnowledgeInjectionRequest = z.infer<typeof KnowledgeInjectionRequestSchema>;
+declare const KnowledgeInjectionResponseSchema: z.ZodObject<{
+    profile: z.ZodNullable<z.ZodObject<{
+        techStack: z.ZodArray<z.ZodString>;
+        architectureType: z.ZodOptional<z.ZodString>;
+        knownPitfalls: z.ZodArray<z.ZodString>;
+        coreConventions: z.ZodArray<z.ZodString>;
+        lastUpdatedAt: z.ZodNumber;
+        lastUpdatedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        entryType: z.ZodEnum<{
+            discovery: "discovery";
+            decision: "decision";
+            fix: "fix";
+            convention: "convention";
+            warning: "warning";
+        }>;
+        title: z.ZodString;
+        content: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        confidence: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type KnowledgeInjectionResponse = z.infer<typeof KnowledgeInjectionResponseSchema>;
+declare const TurnKnowledgeExtractionSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    sessionId: z.ZodString;
+    model: z.ZodString;
+    turnId: z.ZodString;
+    turnData: z.ZodObject<{
+        userMessage: z.ZodString;
+        assistantText: z.ZodString;
+        fileEdits: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            type: z.ZodEnum<{
+                create: "create";
+                edit: "edit";
+            }>;
+        }, z.core.$strip>>;
+        toolCallCount: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type TurnKnowledgeExtraction = z.infer<typeof TurnKnowledgeExtractionSchema>;
+
+export { AgentMessageSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, DaemonStateSchema, KnowledgeActionSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, createEnvelope, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionTaskEndEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema };
+export type { AgentMessage, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, CreateKnowledgeEntryBody, DaemonState, KnowledgeAction, KnowledgeConfidence, KnowledgeContributorType, KnowledgeEntryType, KnowledgeInjectionMode, KnowledgeInjectionRequest, KnowledgeInjectionResponse, KnowledgeStatus, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, ProjectProfile, QueryKnowledgeParams, SessionEnvelope, SessionEvent, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProtocolMessage, SessionRole, SessionTurnEndStatus, TailscaleInfo, TailscaleServeEntry, TunnelEntry, TunnelProviderInfo, TunnelState, TurnKnowledgeExtraction, Update, UpdateBody, UpdateKnowledgeEntryBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue };

package/dist/index.d.mts

@@ -128,6 +128,7 @@ declare const SessionProtocolMessageSchema: z.ZodObject<{
             toolUseId: z.ZodOptional<z.ZodString>;
             description: z.ZodString;
             taskType: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"task-progress">;
             taskId: z.ZodString;
@@ -164,6 +165,13 @@ declare const SessionProtocolMessageSchema: z.ZodObject<{
             suggestion: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"needs-continue">;
+        }, z.core.$strip>, z.ZodObject<{
+            t: z.ZodLiteral<"session-state-changed">;
+            state: z.ZodEnum<{
+                idle: "idle";
+                running: "running";
+                requires_action: "requires_action";
+            }>;
         }, z.core.$strip>], "t">;
     }, z.core.$strip>;
     meta: z.ZodOptional<z.ZodObject<{
@@ -326,6 +334,7 @@ declare const MessageContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             toolUseId: z.ZodOptional<z.ZodString>;
             description: z.ZodString;
             taskType: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"task-progress">;
             taskId: z.ZodString;
@@ -362,6 +371,13 @@ declare const MessageContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             suggestion: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             t: z.ZodLiteral<"needs-continue">;
+        }, z.core.$strip>, z.ZodObject<{
+            t: z.ZodLiteral<"session-state-changed">;
+            state: z.ZodEnum<{
+                idle: "idle";
+                running: "running";
+                requires_action: "requires_action";
+            }>;
         }, z.core.$strip>], "t">;
     }, z.core.$strip>;
     meta: z.ZodOptional<z.ZodObject<{
@@ -883,6 +899,7 @@ declare const sessionTaskStartEventSchema: z.ZodObject<{
     toolUseId: z.ZodOptional<z.ZodString>;
     description: z.ZodString;
     taskType: z.ZodOptional<z.ZodString>;
+    workflowName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const sessionTaskProgressEventSchema: z.ZodObject<{
     t: z.ZodLiteral<"task-progress">;
@@ -925,6 +942,14 @@ declare const sessionPromptSuggestionEventSchema: z.ZodObject<{
 declare const sessionNeedsContinueEventSchema: z.ZodObject<{
     t: z.ZodLiteral<"needs-continue">;
 }, z.core.$strip>;
+declare const sessionStateChangedEventSchema: z.ZodObject<{
+    t: z.ZodLiteral<"session-state-changed">;
+    state: z.ZodEnum<{
+        idle: "idle";
+        running: "running";
+        requires_action: "requires_action";
+    }>;
+}, z.core.$strip>;
 declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     t: z.ZodLiteral<"text">;
     text: z.ZodString;
@@ -1003,6 +1028,7 @@ declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     toolUseId: z.ZodOptional<z.ZodString>;
     description: z.ZodString;
     taskType: z.ZodOptional<z.ZodString>;
+    workflowName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"task-progress">;
     taskId: z.ZodString;
@@ -1039,6 +1065,13 @@ declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     suggestion: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"needs-continue">;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"session-state-changed">;
+    state: z.ZodEnum<{
+        idle: "idle";
+        running: "running";
+        requires_action: "requires_action";
+    }>;
 }, z.core.$strip>], "t">;
 type SessionEvent = z.infer<typeof sessionEventSchema>;
 declare const sessionEnvelopeSchema: z.ZodObject<{
@@ -1128,6 +1161,7 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
         toolUseId: z.ZodOptional<z.ZodString>;
         description: z.ZodString;
         taskType: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         t: z.ZodLiteral<"task-progress">;
         taskId: z.ZodString;
@@ -1164,6 +1198,13 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
         suggestion: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         t: z.ZodLiteral<"needs-continue">;
+    }, z.core.$strip>, z.ZodObject<{
+        t: z.ZodLiteral<"session-state-changed">;
+        state: z.ZodEnum<{
+            idle: "idle";
+            running: "running";
+            requires_action: "requires_action";
+        }>;
     }, z.core.$strip>], "t">;
 }, z.core.$strip>;
 type SessionEnvelope = z.infer<typeof sessionEnvelopeSchema>;
@@ -1360,5 +1401,188 @@ declare const DaemonStateSchema: z.ZodObject<{
 }, z.core.$strip>;
 type DaemonState = z.infer<typeof DaemonStateSchema>;
 
-export { AgentMessageSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, DaemonStateSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, UpdateBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, createEnvelope, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStopEventSchema, sessionTaskEndEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema };
-export type { AgentMessage, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, DaemonState, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, SessionEnvelope, SessionEvent, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProtocolMessage, SessionRole, SessionTurnEndStatus, TailscaleInfo, TailscaleServeEntry, TunnelEntry, TunnelProviderInfo, TunnelState, Update, UpdateBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue };
+declare const KnowledgeEntryTypeSchema: z.ZodEnum<{
+    discovery: "discovery";
+    decision: "decision";
+    fix: "fix";
+    convention: "convention";
+    warning: "warning";
+}>;
+type KnowledgeEntryType = z.infer<typeof KnowledgeEntryTypeSchema>;
+declare const KnowledgeContributorTypeSchema: z.ZodEnum<{
+    user: "user";
+    session: "session";
+    supervisor: "supervisor";
+}>;
+type KnowledgeContributorType = z.infer<typeof KnowledgeContributorTypeSchema>;
+declare const KnowledgeActionSchema: z.ZodEnum<{
+    create: "create";
+    amend: "amend";
+    supersede: "supersede";
+    verify: "verify";
+}>;
+type KnowledgeAction = z.infer<typeof KnowledgeActionSchema>;
+declare const KnowledgeStatusSchema: z.ZodEnum<{
+    active: "active";
+    superseded: "superseded";
+    archived: "archived";
+}>;
+type KnowledgeStatus = z.infer<typeof KnowledgeStatusSchema>;
+declare const KnowledgeConfidenceSchema: z.ZodEnum<{
+    high: "high";
+    medium: "medium";
+    low: "low";
+}>;
+type KnowledgeConfidence = z.infer<typeof KnowledgeConfidenceSchema>;
+declare const CreateKnowledgeEntryBodySchema: z.ZodObject<{
+    entryType: z.ZodEnum<{
+        discovery: "discovery";
+        decision: "decision";
+        fix: "fix";
+        convention: "convention";
+        warning: "warning";
+    }>;
+    contributorType: z.ZodEnum<{
+        user: "user";
+        session: "session";
+        supervisor: "supervisor";
+    }>;
+    action: z.ZodEnum<{
+        create: "create";
+        amend: "amend";
+        supersede: "supersede";
+        verify: "verify";
+    }>;
+    title: z.ZodString;
+    content: z.ZodString;
+    request: z.ZodOptional<z.ZodString>;
+    findings: z.ZodOptional<z.ZodString>;
+    analysis: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodOptional<z.ZodString>;
+    nextSteps: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    confidence: z.ZodDefault<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    supersedesId: z.ZodOptional<z.ZodString>;
+    relatedIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    affectedFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type CreateKnowledgeEntryBody = z.infer<typeof CreateKnowledgeEntryBodySchema>;
+declare const UpdateKnowledgeEntryBodySchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        superseded: "superseded";
+        archived: "archived";
+    }>>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    confidence: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+}, z.core.$strip>;
+type UpdateKnowledgeEntryBody = z.infer<typeof UpdateKnowledgeEntryBodySchema>;
+declare const QueryKnowledgeParamsSchema: z.ZodObject<{
+    entryType: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        decision: "decision";
+        fix: "fix";
+        convention: "convention";
+        warning: "warning";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        superseded: "superseded";
+        archived: "archived";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type QueryKnowledgeParams = z.infer<typeof QueryKnowledgeParamsSchema>;
+declare const ProjectProfileSchema: z.ZodObject<{
+    techStack: z.ZodArray<z.ZodString>;
+    architectureType: z.ZodOptional<z.ZodString>;
+    knownPitfalls: z.ZodArray<z.ZodString>;
+    coreConventions: z.ZodArray<z.ZodString>;
+    lastUpdatedAt: z.ZodNumber;
+    lastUpdatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ProjectProfile = z.infer<typeof ProjectProfileSchema>;
+declare const KnowledgeInjectionModeSchema: z.ZodEnum<{
+    auto: "auto";
+    full: "full";
+    minimal: "minimal";
+}>;
+type KnowledgeInjectionMode = z.infer<typeof KnowledgeInjectionModeSchema>;
+declare const KnowledgeInjectionRequestSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        auto: "auto";
+        full: "full";
+        minimal: "minimal";
+    }>;
+    contextHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type KnowledgeInjectionRequest = z.infer<typeof KnowledgeInjectionRequestSchema>;
+declare const KnowledgeInjectionResponseSchema: z.ZodObject<{
+    profile: z.ZodNullable<z.ZodObject<{
+        techStack: z.ZodArray<z.ZodString>;
+        architectureType: z.ZodOptional<z.ZodString>;
+        knownPitfalls: z.ZodArray<z.ZodString>;
+        coreConventions: z.ZodArray<z.ZodString>;
+        lastUpdatedAt: z.ZodNumber;
+        lastUpdatedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        entryType: z.ZodEnum<{
+            discovery: "discovery";
+            decision: "decision";
+            fix: "fix";
+            convention: "convention";
+            warning: "warning";
+        }>;
+        title: z.ZodString;
+        content: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        confidence: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type KnowledgeInjectionResponse = z.infer<typeof KnowledgeInjectionResponseSchema>;
+declare const TurnKnowledgeExtractionSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    sessionId: z.ZodString;
+    model: z.ZodString;
+    turnId: z.ZodString;
+    turnData: z.ZodObject<{
+        userMessage: z.ZodString;
+        assistantText: z.ZodString;
+        fileEdits: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            type: z.ZodEnum<{
+                create: "create";
+                edit: "edit";
+            }>;
+        }, z.core.$strip>>;
+        toolCallCount: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type TurnKnowledgeExtraction = z.infer<typeof TurnKnowledgeExtractionSchema>;
+
+export { AgentMessageSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, DaemonStateSchema, KnowledgeActionSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, createEnvelope, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionTaskEndEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema };
+export type { AgentMessage, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, CreateKnowledgeEntryBody, DaemonState, KnowledgeAction, KnowledgeConfidence, KnowledgeContributorType, KnowledgeEntryType, KnowledgeInjectionMode, KnowledgeInjectionRequest, KnowledgeInjectionResponse, KnowledgeStatus, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, ProjectProfile, QueryKnowledgeParams, SessionEnvelope, SessionEvent, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProtocolMessage, SessionRole, SessionTurnEndStatus, TailscaleInfo, TailscaleServeEntry, TunnelEntry, TunnelProviderInfo, TunnelState, TurnKnowledgeExtraction, Update, UpdateBody, UpdateKnowledgeEntryBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue };

package/dist/index.mjs

@@ -93,7 +93,9 @@ const sessionTaskStartEventSchema = z.object({
   taskId: z.string(),
   toolUseId: z.string().optional(),
   description: z.string(),
-  taskType: z.string().optional()
+  taskType: z.string().optional(),
+  /** meta.name from the workflow script (e.g. 'spec'). Only set when taskType is 'local_workflow'. */
+  workflowName: z.string().optional()
 });
 const sessionTaskProgressEventSchema = z.object({
   t: z.literal("task-progress"),
@@ -133,6 +135,11 @@ const sessionPromptSuggestionEventSchema = z.object({
 const sessionNeedsContinueEventSchema = z.object({
   t: z.literal("needs-continue")
 });
+const sessionStateChangedEventSchema = z.object({
+  t: z.literal("session-state-changed"),
+  /** Authoritative session lifecycle state from the SDK */
+  state: z.enum(["idle", "running", "requires_action"])
+});
 const sessionEventSchema = z.discriminatedUnion("t", [
   sessionTextEventSchema,
   sessionServiceMessageEventSchema,
@@ -149,7 +156,8 @@ const sessionEventSchema = z.discriminatedUnion("t", [
   sessionTaskEndEventSchema,
   sessionToolProgressEventSchema,
   sessionPromptSuggestionEventSchema,
-  sessionNeedsContinueEventSchema
+  sessionNeedsContinueEventSchema,
+  sessionStateChangedEventSchema
 ]);
 const sessionEnvelopeSchema = z.object({
   id: z.string(),
@@ -168,7 +176,7 @@ const sessionEnvelopeSchema = z.object({
       path: ["role"]
     });
   }
-  if ((envelope.ev.t === "start" || envelope.ev.t === "stop" || envelope.ev.t === "usage-update" || envelope.ev.t === "task-start" || envelope.ev.t === "task-progress" || envelope.ev.t === "task-end" || envelope.ev.t === "tool-progress" || envelope.ev.t === "prompt-suggestion" || envelope.ev.t === "needs-continue") && envelope.role !== "agent") {
+  if ((envelope.ev.t === "start" || envelope.ev.t === "stop" || envelope.ev.t === "usage-update" || envelope.ev.t === "task-start" || envelope.ev.t === "task-progress" || envelope.ev.t === "task-end" || envelope.ev.t === "tool-progress" || envelope.ev.t === "prompt-suggestion" || envelope.ev.t === "needs-continue" || envelope.ev.t === "session-state-changed") && envelope.role !== "agent") {
     ctx.addIssue({
       code: z.ZodIssueCode.custom,
       message: `${envelope.ev.t} events must use role "agent"`,
@@ -366,4 +374,127 @@ const DaemonStateSchema = z.object({
   tunnels: TunnelStateSchema.optional()
 });
 
-export { AgentMessageSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, DaemonStateSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, UpdateBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, createEnvelope, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStopEventSchema, sessionTaskEndEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema };
+const KnowledgeEntryTypeSchema = z.enum([
+  "discovery",
+  // New insight or finding
+  "decision",
+  // Architecture / tech choice
+  "fix",
+  // Bug fix record
+  "convention",
+  // Code convention / process rule
+  "warning"
+  // Known pitfall or gotcha
+]);
+const KnowledgeContributorTypeSchema = z.enum([
+  "session",
+  // Auto-generated by Claude session
+  "supervisor",
+  // Generated by Supervisor analysis
+  "user"
+  // Manually added by user
+]);
+const KnowledgeActionSchema = z.enum([
+  "create",
+  // New entry
+  "amend",
+  // Correction / supplement
+  "supersede",
+  // Replace old knowledge
+  "verify"
+  // Confirm still valid
+]);
+const KnowledgeStatusSchema = z.enum([
+  "active",
+  // Currently valid
+  "superseded",
+  // Replaced by newer knowledge
+  "archived"
+  // Manually archived by user
+]);
+const KnowledgeConfidenceSchema = z.enum(["high", "medium", "low"]);
+const CreateKnowledgeEntryBodySchema = z.object({
+  entryType: KnowledgeEntryTypeSchema,
+  contributorType: KnowledgeContributorTypeSchema,
+  action: KnowledgeActionSchema,
+  title: z.string().min(1).max(200),
+  content: z.string().min(1),
+  // Structured SOAP-like fields (optional)
+  request: z.string().optional(),
+  // S: What the user asked
+  findings: z.string().optional(),
+  // O: What was discovered
+  analysis: z.string().optional(),
+  // A: Root cause / assessment
+  outcome: z.string().optional(),
+  // P: What was done
+  nextSteps: z.string().optional(),
+  // Follow-up suggestions
+  tags: z.array(z.string().max(50)).max(20).default([]),
+  confidence: KnowledgeConfidenceSchema.default("medium"),
+  sessionId: z.string().optional(),
+  model: z.string().optional(),
+  supersedesId: z.string().optional(),
+  relatedIds: z.array(z.string()).max(10).default([]),
+  affectedFiles: z.array(z.string()).max(50).default([])
+});
+const UpdateKnowledgeEntryBodySchema = z.object({
+  status: KnowledgeStatusSchema.optional(),
+  pinned: z.boolean().optional(),
+  title: z.string().min(1).max(200).optional(),
+  content: z.string().min(1).optional(),
+  tags: z.array(z.string().max(50)).max(20).optional(),
+  confidence: KnowledgeConfidenceSchema.optional()
+});
+const QueryKnowledgeParamsSchema = z.object({
+  entryType: KnowledgeEntryTypeSchema.optional(),
+  status: KnowledgeStatusSchema.optional(),
+  tags: z.array(z.string()).optional(),
+  search: z.string().optional(),
+  limit: z.number().int().min(1).max(100).default(20),
+  offset: z.number().int().min(0).default(0)
+});
+const ProjectProfileSchema = z.object({
+  techStack: z.array(z.string()),
+  architectureType: z.string().optional(),
+  knownPitfalls: z.array(z.string()),
+  coreConventions: z.array(z.string()),
+  lastUpdatedAt: z.number(),
+  lastUpdatedBy: z.string().optional()
+});
+const KnowledgeInjectionModeSchema = z.enum(["auto", "full", "minimal"]);
+const KnowledgeInjectionRequestSchema = z.object({
+  mode: KnowledgeInjectionModeSchema,
+  contextHints: z.array(z.string()).optional()
+  // Keywords from user message for relevance
+});
+const KnowledgeInjectionResponseSchema = z.object({
+  profile: ProjectProfileSchema.nullable(),
+  entries: z.array(z.object({
+    id: z.string(),
+    entryType: KnowledgeEntryTypeSchema,
+    title: z.string(),
+    content: z.string(),
+    tags: z.array(z.string()),
+    confidence: KnowledgeConfidenceSchema,
+    createdAt: z.string()
+  }))
+});
+const TurnKnowledgeExtractionSchema = z.object({
+  projectId: z.string(),
+  sessionId: z.string(),
+  model: z.string(),
+  turnId: z.string(),
+  turnData: z.object({
+    userMessage: z.string().max(2e3),
+    assistantText: z.string().max(5e3),
+    fileEdits: z.array(z.object({
+      path: z.string(),
+      type: z.enum(["create", "edit"])
+    })).max(50),
+    toolCallCount: z.number().int(),
+    outputTokens: z.number().int()
+  })
+});
+
+export { AgentMessageSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, DaemonStateSchema, KnowledgeActionSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, createEnvelope, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionTaskEndEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmmao/happy-wire",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Shared message wire types and Zod schemas for Happy clients and services",
   "author": "kmmao",
   "license": "MIT",