@keel_flow/schema 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jglasskatz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @keel_flow/schema
+
+Versioned Zod schemas and derived TypeScript types for all Keel data structures.
+
+Exports: `ArchitectureMap`, `ArchitectureDelta`, `Principle`, `PrinciplePack`, `Violation`,
+`VerifyResult`, `AgentEvent`, `SpecCheckResult`, `Build`, `LearningProposal`, `Goal`,
+`GoalAction`, `GoalTrigger`, and the `SCHEMA_VERSION` constant.
+
+Part of the [Keel](https://github.com/jglasskatz/keel) framework.
+
+## Install
+
+```
+npm install @keel_flow/schema
+```
+
+## License
+
+MIT

package/dist/agent-event.d.ts

@@ -0,0 +1,90 @@
+import { z } from "zod";
+export declare const TriggeredBySchema: z.ZodObject<{
+    kind: z.ZodEnum<["user", "schedule", "event", "test"]>;
+    jobId: z.ZodOptional<z.ZodString>;
+    goalId: z.ZodOptional<z.ZodString>;
+    triggerEventId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "user" | "schedule" | "event" | "test";
+    jobId?: string | undefined;
+    goalId?: string | undefined;
+    triggerEventId?: string | undefined;
+}, {
+    kind: "user" | "schedule" | "event" | "test";
+    jobId?: string | undefined;
+    goalId?: string | undefined;
+    triggerEventId?: string | undefined;
+}>;
+export type TriggeredBy = z.infer<typeof TriggeredBySchema>;
+export declare const AgentEventKindSchema: z.ZodEnum<["session.start", "session.end", "orchestrator.decompose", "orchestrator.dispatch", "orchestrator.review", "sub-agent.start", "sub-agent.complete", "sub-agent.fail", "tool.call", "tool.result", "tool.error", "verify.run", "verify.check", "spec-judge.rubric", "spec-judge.claim", "spec-judge.adversarial", "spec-judge.bidirectional", "kb.ingest", "kb.retrieve", "kb.rerank", "memory.write", "skill.read", "user.steer", "clarifying.question", "build.start", "build.draft", "build.summary", "build.approval-request", "build.approved", "build.rejected", "build.spec-codified", "build.executing", "build.complete", "job.start", "job.complete", "job.fail", "job.skipped", "reflect.generated", "learn.proposal-loaded", "learn.proposal-accepted", "learn.proposal-rejected", "learn.proposal-deferred", "learn.applied", "memory.added", "memory.removed", "goal.evaluate-start", "goal.action-proposed", "goal.action-approved", "goal.action-rejected", "goal.action-executed", "goal.evaluate-end", "goal.failed", "goal.paused"]>;
+export type AgentEventKind = z.infer<typeof AgentEventKindSchema>;
+export declare const AgentEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    ts: z.ZodString;
+    sessionId: z.ZodString;
+    parentEventId: z.ZodNullable<z.ZodString>;
+    workspaceId: z.ZodNullable<z.ZodString>;
+    triggeredBy: z.ZodObject<{
+        kind: z.ZodEnum<["user", "schedule", "event", "test"]>;
+        jobId: z.ZodOptional<z.ZodString>;
+        goalId: z.ZodOptional<z.ZodString>;
+        triggerEventId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "user" | "schedule" | "event" | "test";
+        jobId?: string | undefined;
+        goalId?: string | undefined;
+        triggerEventId?: string | undefined;
+    }, {
+        kind: "user" | "schedule" | "event" | "test";
+        jobId?: string | undefined;
+        goalId?: string | undefined;
+        triggerEventId?: string | undefined;
+    }>;
+    kind: z.ZodEnum<["session.start", "session.end", "orchestrator.decompose", "orchestrator.dispatch", "orchestrator.review", "sub-agent.start", "sub-agent.complete", "sub-agent.fail", "tool.call", "tool.result", "tool.error", "verify.run", "verify.check", "spec-judge.rubric", "spec-judge.claim", "spec-judge.adversarial", "spec-judge.bidirectional", "kb.ingest", "kb.retrieve", "kb.rerank", "memory.write", "skill.read", "user.steer", "clarifying.question", "build.start", "build.draft", "build.summary", "build.approval-request", "build.approved", "build.rejected", "build.spec-codified", "build.executing", "build.complete", "job.start", "job.complete", "job.fail", "job.skipped", "reflect.generated", "learn.proposal-loaded", "learn.proposal-accepted", "learn.proposal-rejected", "learn.proposal-deferred", "learn.applied", "memory.added", "memory.removed", "goal.evaluate-start", "goal.action-proposed", "goal.action-approved", "goal.action-rejected", "goal.action-executed", "goal.evaluate-end", "goal.failed", "goal.paused"]>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    latencyMs: z.ZodOptional<z.ZodNumber>;
+    costUsd: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "session.start" | "session.end" | "orchestrator.decompose" | "orchestrator.dispatch" | "orchestrator.review" | "sub-agent.start" | "sub-agent.complete" | "sub-agent.fail" | "tool.call" | "tool.result" | "tool.error" | "verify.run" | "verify.check" | "spec-judge.rubric" | "spec-judge.claim" | "spec-judge.adversarial" | "spec-judge.bidirectional" | "kb.ingest" | "kb.retrieve" | "kb.rerank" | "memory.write" | "skill.read" | "user.steer" | "clarifying.question" | "build.start" | "build.draft" | "build.summary" | "build.approval-request" | "build.approved" | "build.rejected" | "build.spec-codified" | "build.executing" | "build.complete" | "job.start" | "job.complete" | "job.fail" | "job.skipped" | "reflect.generated" | "learn.proposal-loaded" | "learn.proposal-accepted" | "learn.proposal-rejected" | "learn.proposal-deferred" | "learn.applied" | "memory.added" | "memory.removed" | "goal.evaluate-start" | "goal.action-proposed" | "goal.action-approved" | "goal.action-rejected" | "goal.action-executed" | "goal.evaluate-end" | "goal.failed" | "goal.paused";
+    id: string;
+    ts: string;
+    sessionId: string;
+    parentEventId: string | null;
+    workspaceId: string | null;
+    triggeredBy: {
+        kind: "user" | "schedule" | "event" | "test";
+        jobId?: string | undefined;
+        goalId?: string | undefined;
+        triggerEventId?: string | undefined;
+    };
+    payload: Record<string, unknown>;
+    latencyMs?: number | undefined;
+    costUsd?: number | undefined;
+    model?: string | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+}, {
+    kind: "session.start" | "session.end" | "orchestrator.decompose" | "orchestrator.dispatch" | "orchestrator.review" | "sub-agent.start" | "sub-agent.complete" | "sub-agent.fail" | "tool.call" | "tool.result" | "tool.error" | "verify.run" | "verify.check" | "spec-judge.rubric" | "spec-judge.claim" | "spec-judge.adversarial" | "spec-judge.bidirectional" | "kb.ingest" | "kb.retrieve" | "kb.rerank" | "memory.write" | "skill.read" | "user.steer" | "clarifying.question" | "build.start" | "build.draft" | "build.summary" | "build.approval-request" | "build.approved" | "build.rejected" | "build.spec-codified" | "build.executing" | "build.complete" | "job.start" | "job.complete" | "job.fail" | "job.skipped" | "reflect.generated" | "learn.proposal-loaded" | "learn.proposal-accepted" | "learn.proposal-rejected" | "learn.proposal-deferred" | "learn.applied" | "memory.added" | "memory.removed" | "goal.evaluate-start" | "goal.action-proposed" | "goal.action-approved" | "goal.action-rejected" | "goal.action-executed" | "goal.evaluate-end" | "goal.failed" | "goal.paused";
+    id: string;
+    ts: string;
+    sessionId: string;
+    parentEventId: string | null;
+    workspaceId: string | null;
+    triggeredBy: {
+        kind: "user" | "schedule" | "event" | "test";
+        jobId?: string | undefined;
+        goalId?: string | undefined;
+        triggerEventId?: string | undefined;
+    };
+    payload: Record<string, unknown>;
+    latencyMs?: number | undefined;
+    costUsd?: number | undefined;
+    model?: string | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+}>;
+export type AgentEvent = z.infer<typeof AgentEventSchema>;
+//# sourceMappingURL=agent-event.d.ts.map

package/dist/agent-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-event.d.ts","sourceRoot":"","sources":["../src/agent-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,oBAAoB,kgCAsD/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/agent-event.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+export const TriggeredBySchema = z.object({
+    kind: z.enum(["user", "schedule", "event", "test"]),
+    jobId: z.string().optional(),
+    goalId: z.string().uuid().optional(),
+    triggerEventId: z.string().uuid().optional(),
+});
+export const AgentEventKindSchema = z.enum([
+    "session.start",
+    "session.end",
+    "orchestrator.decompose",
+    "orchestrator.dispatch",
+    "orchestrator.review",
+    "sub-agent.start",
+    "sub-agent.complete",
+    "sub-agent.fail",
+    "tool.call",
+    "tool.result",
+    "tool.error",
+    "verify.run",
+    "verify.check",
+    "spec-judge.rubric",
+    "spec-judge.claim",
+    "spec-judge.adversarial",
+    "spec-judge.bidirectional",
+    "kb.ingest",
+    "kb.retrieve",
+    "kb.rerank",
+    "memory.write",
+    "skill.read",
+    "user.steer",
+    "clarifying.question",
+    "build.start",
+    "build.draft",
+    "build.summary",
+    "build.approval-request",
+    "build.approved",
+    "build.rejected",
+    "build.spec-codified",
+    "build.executing",
+    "build.complete",
+    "job.start",
+    "job.complete",
+    "job.fail",
+    "job.skipped",
+    "reflect.generated",
+    "learn.proposal-loaded",
+    "learn.proposal-accepted",
+    "learn.proposal-rejected",
+    "learn.proposal-deferred",
+    "learn.applied",
+    "memory.added",
+    "memory.removed",
+    "goal.evaluate-start",
+    "goal.action-proposed",
+    "goal.action-approved",
+    "goal.action-rejected",
+    "goal.action-executed",
+    "goal.evaluate-end",
+    "goal.failed",
+    "goal.paused",
+]);
+export const AgentEventSchema = z.object({
+    id: z.string().uuid(),
+    ts: z.string().datetime(),
+    sessionId: z.string().uuid(),
+    parentEventId: z.string().uuid().nullable(),
+    workspaceId: z.string().uuid().nullable(),
+    triggeredBy: TriggeredBySchema,
+    kind: AgentEventKindSchema,
+    payload: z.record(z.unknown()),
+    latencyMs: z.number().int().nonnegative().optional(),
+    costUsd: z.number().nonnegative().optional(),
+    model: z.string().optional(),
+    inputTokens: z.number().int().nonnegative().optional(),
+    outputTokens: z.number().int().nonnegative().optional(),
+});
+//# sourceMappingURL=agent-event.js.map

package/dist/agent-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-event.js","sourceRoot":"","sources":["../src/agent-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,eAAe;IACf,aAAa;IACb,wBAAwB;IACxB,uBAAuB;IACvB,qBAAqB;IACrB,iBAAiB;IACjB,oBAAoB;IACpB,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,mBAAmB;IACnB,kBAAkB;IAClB,wBAAwB;IACxB,0BAA0B;IAC1B,WAAW;IACX,aAAa;IACb,WAAW;IACX,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,aAAa;IACb,aAAa;IACb,eAAe;IACf,wBAAwB;IACxB,gBAAgB;IAChB,gBAAgB;IAChB,qBAAqB;IACrB,iBAAiB;IACjB,gBAAgB;IAChB,WAAW;IACX,cAAc;IACd,UAAU;IACV,aAAa;IACb,mBAAmB;IACnB,uBAAuB;IACvB,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;IACnB,aAAa;IACb,aAAa;CACd,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,WAAW,EAAE,iBAAiB;IAC9B,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACtD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC"}