kiokuko-dsh 0.1.0

package/dist/server/routes/agent-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runs.js","sourceRoot":"","sources":["../../../src/server/routes/agent-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAMlE,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,aAAa,GAAG,GAAG,CAAC;AAsB1B,SAAS,OAAO;IACd,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAQ,EAAE,OAA8B;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAiB,CAAC;YAAE,OAAO,EAAE,CAAC;QACrE,MAAM,CAAC,GAAG,CAAC,GAAiB,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAQ;IACrC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAuC,EAAE,KAAwB;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClJ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,MAAe;IAC5D,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC;IAC/B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK;WACvG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,yBAAyB,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpG,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1D,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,iBAAiB;gBAAE,WAAW,IAAI,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,QAAQ,KAAK,SAAS,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;gBACjD,SAAS,EAAE,YAAY;gBACvB,SAAS,EAAE,IAAI;gBACf,cAAc;gBACd,WAAW,EAAE,OAAO,CAAC,IAAI;aAC1B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBACpE,cAAc;gBACd,OAAO,EAAE,OAAO,CAAC,IAAI;aACtB,CAAC,CAAC,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAC9C,OAAO,EACP,IAAI,EACJ,wBAAwB,CAAC,OAAO,CAAC,IAAI,CAAC,CACvC,CAAC;YACF,OAAO,eAAe,CAAC,YAAY,EAAE,EAAE,GAAG,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAClG,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC1C,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjE,MAAM,KAAK,GAA4B,EAAE,SAAS,EAAE,CAAC;YACrD,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,EAAE,CAAC;gBAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAChC,IAAI,KAAK,KAAK,SAAS;oBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;YAChD,CAAC;YACD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS;gBAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YAC7C,OAAO,eAAe,CAAC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;gBACpC,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBACtD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;oBACjD,SAAS,EAAE,aAAa;oBACxB,SAAS,EAAE,KAAK;oBAChB,cAAc;oBACd,WAAW,EAAE,OAAO,CAAC,IAAI;iBAC1B,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;oBACrE,KAAK;oBACL,cAAc;oBACd,OAAO,EAAE,OAAO,CAAC,IAAI;iBACtB,CAAC,CAAC,CAAC;gBACJ,OAAO,eAAe,CAAC,aAAa,EAAE,EAAE,GAAG,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5B,OAAO,eAAe,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,QAAgB;IACjE,IAAI,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC;IACnE,IAAI,MAAM,KAAK,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACvE,IAAI,MAAM,KAAK,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAC7F,IAAI,MAAM,KAAK,KAAK,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/server/routes/request-binding.d.ts

@@ -0,0 +1,5 @@
+export declare const AGENT_MUTATION_OPERATIONS: readonly ["agent.open", "agent.answer", "agent.events", "agent.close", "agent.checkpoint", "agent.feedback"];
+export type AgentMutationOperation = (typeof AGENT_MUTATION_OPERATIONS)[number];
+/** Hash the exact validated HTTP mutation identity before any durable write begins. */
+export declare function agentRequestBindingHash(value: unknown): string;
+//# sourceMappingURL=request-binding.d.ts.map

package/dist/server/routes/request-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-binding.d.ts","sourceRoot":"","sources":["../../../src/server/routes/request-binding.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,yBAAyB,8GAO5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAchF,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuB9D"}

package/dist/server/routes/request-binding.js

@@ -0,0 +1,49 @@
+import { isProxy } from 'node:util/types';
+import { KiokukoError } from '../../errors.js';
+import { canonicalContentHash } from '../../serialization/validate.js';
+export const AGENT_MUTATION_OPERATIONS = [
+    'agent.open',
+    'agent.answer',
+    'agent.events',
+    'agent.close',
+    'agent.checkpoint',
+    'agent.feedback',
+];
+const BINDING_FIELDS = ['operation', 'pathRunId', 'idempotencyKey', 'requestBody'];
+function invalid() {
+    throw new KiokukoError('VALIDATION_ERROR', 'Agent request binding is invalid');
+}
+function plainObject(value) {
+    if (typeof value !== 'object' || value === null || isProxy(value) || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/** Hash the exact validated HTTP mutation identity before any durable write begins. */
+export function agentRequestBindingHash(value) {
+    if (!plainObject(value))
+        invalid();
+    const keys = Reflect.ownKeys(value);
+    if (keys.length !== BINDING_FIELDS.length
+        || keys.some((key) => typeof key !== 'string' || !BINDING_FIELDS.includes(key))) {
+        invalid();
+    }
+    for (const field of BINDING_FIELDS) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, field);
+        if (descriptor === undefined || !Object.hasOwn(descriptor, 'value') || descriptor.enumerable !== true)
+            invalid();
+    }
+    const operation = value.operation;
+    const pathRunId = value.pathRunId;
+    const idempotencyKey = value.idempotencyKey;
+    const requestBody = value.requestBody;
+    if (typeof operation !== 'string'
+        || !AGENT_MUTATION_OPERATIONS.includes(operation)
+        || pathRunId !== null && (typeof pathRunId !== 'string' || pathRunId.length === 0)
+        || idempotencyKey !== null && (typeof idempotencyKey !== 'string' || idempotencyKey.length === 0)
+        || !plainObject(requestBody)) {
+        invalid();
+    }
+    return canonicalContentHash({ operation, pathRunId, idempotencyKey, requestBody });
+}
+//# sourceMappingURL=request-binding.js.map

package/dist/server/routes/request-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-binding.js","sourceRoot":"","sources":["../../../src/server/routes/request-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY;IACZ,cAAc;IACd,cAAc;IACd,aAAa;IACb,kBAAkB;IAClB,gBAAgB;CACR,CAAC;AAIX,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,CAAU,CAAC;AAE5F,SAAS,OAAO;IACd,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,kCAAkC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxG,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM;WACpC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAsC,CAAC,CAAC,EAAE,CAAC;QACrH,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;IACnH,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,IAAI,OAAO,SAAS,KAAK,QAAQ;WAC5B,CAAC,yBAAyB,CAAC,QAAQ,CAAC,SAAmC,CAAC;WACxE,SAAS,KAAK,IAAI,IAAI,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;WAC/E,cAAc,KAAK,IAAI,IAAI,CAAC,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;WAC9F,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,oBAAoB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/server/routes/task5-support.d.ts

@@ -0,0 +1,4 @@
+import type { ContextBrokerPersistence } from '../../context/broker.js';
+import type { AgentRouteContext } from './agent-runs.js';
+export declare function brokerPersistence(context: AgentRouteContext): ContextBrokerPersistence;
+//# sourceMappingURL=task5-support.d.ts.map

package/dist/server/routes/task5-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5-support.d.ts","sourceRoot":"","sources":["../../../src/server/routes/task5-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,wBAAwB,CAItF"}

package/dist/server/routes/task5-support.js

@@ -0,0 +1,6 @@
+export function brokerPersistence(context) {
+    return {
+        enqueueWrite: (operation) => context.enqueueWrite(operation),
+    };
+}
+//# sourceMappingURL=task5-support.js.map

package/dist/server/routes/task5-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5-support.js","sourceRoot":"","sources":["../../../src/server/routes/task5-support.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,OAA0B;IAC1D,OAAO;QACL,YAAY,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/server/routes/task5.d.ts

@@ -0,0 +1,5 @@
+import type { V1RouteHandler } from '../router.js';
+import { type AgentRouteContext } from './agent-runs.js';
+export declare function createTask5Route(context: AgentRouteContext): V1RouteHandler;
+export declare function task5Operation(method: string, pathname: string): string | undefined;
+//# sourceMappingURL=task5.d.ts.map

package/dist/server/routes/task5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5.d.ts","sourceRoot":"","sources":["../../../src/server/routes/task5.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAkCzB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CA0C3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnF"}

package/dist/server/routes/task5.js

@@ -0,0 +1,85 @@
+import { KiokukoError } from '../../errors.js';
+import { successEnvelope } from '../../serialization/envelope.js';
+import { AgentCheckpointUseCase } from '../agent-checkpoint-use-case.js';
+import { decodeRunId, requireIdempotencyKey, requireNoQuery, runIdSegment, } from './agent-runs.js';
+import { agentRequestBindingHash } from './request-binding.js';
+const CHECKPOINTS_SUFFIX = 'checkpoints';
+const FEEDBACK_SUFFIX = 'feedback';
+function legacyCheckpointUseCase(context) {
+    const legacy = context.checkpointService;
+    if (legacy === undefined) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Agent checkpoint use case is not configured');
+    }
+    const checkpointMutation = {
+        checkpoint: (input) => {
+            const value = legacy.checkpoint(input);
+            return {
+                ...value,
+                preliminaryRecommendations: [...(value.recommendations ?? [])],
+            };
+        },
+    };
+    const nudgeDelivery = {
+        deliver: (input) => legacy.deliverNudge(input),
+    };
+    return new AgentCheckpointUseCase({
+        database: context.database,
+        service: context.service,
+        checkpointMutation,
+        validateMutationAcknowledgement: false,
+        nudgeDelivery,
+        broker: context.broker,
+        enqueueWrite: context.enqueueWrite,
+    });
+}
+export function createTask5Route(context) {
+    const checkpoint = context.agentCheckpoint ?? legacyCheckpointUseCase(context);
+    return async (request) => {
+        if (request.method === 'POST') {
+            const rawCheckpointRunId = runIdSegment(request.url.pathname, CHECKPOINTS_SUFFIX);
+            if (rawCheckpointRunId !== undefined) {
+                requireNoQuery(request.url);
+                const runId = decodeRunId(rawCheckpointRunId);
+                const idempotencyKey = requireIdempotencyKey(request);
+                const requestBindingHash = agentRequestBindingHash({
+                    operation: 'agent.checkpoint',
+                    pathRunId: runId,
+                    idempotencyKey,
+                    requestBody: request.body,
+                });
+                const data = await checkpoint.execute({
+                    runId,
+                    idempotencyKey,
+                    body: request.body,
+                    requestBindingHash,
+                });
+                return successEnvelope('agent.checkpoint', data);
+            }
+            const rawFeedbackRunId = runIdSegment(request.url.pathname, FEEDBACK_SUFFIX);
+            if (rawFeedbackRunId !== undefined) {
+                requireNoQuery(request.url);
+                const runId = decodeRunId(rawFeedbackRunId);
+                const idempotencyKey = requireIdempotencyKey(request);
+                const requestBindingHash = agentRequestBindingHash({
+                    operation: 'agent.feedback',
+                    pathRunId: runId,
+                    idempotencyKey,
+                    requestBody: request.body,
+                });
+                const data = await context.enqueueWrite(() => context.feedbackService.feedback({ runId, idempotencyKey, request: request.body }));
+                return successEnvelope('agent.feedback', { ...data, requestBindingHash });
+            }
+        }
+        return undefined;
+    };
+}
+export function task5Operation(method, pathname) {
+    if (method !== 'POST')
+        return undefined;
+    if (runIdSegment(pathname, CHECKPOINTS_SUFFIX) !== undefined)
+        return 'agent.checkpoint';
+    if (runIdSegment(pathname, FEEDBACK_SUFFIX) !== undefined)
+        return 'agent.feedback';
+    return undefined;
+}
+//# sourceMappingURL=task5.js.map

package/dist/server/routes/task5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5.js","sourceRoot":"","sources":["../../../src/server/routes/task5.ts"],"names":[],"mappings":"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"}

package/dist/server/runtime-descriptor.d.ts

@@ -0,0 +1,24 @@
+export interface RuntimeDescriptor {
+    protocolVersion: '1';
+    instanceId: string;
+    pid: number;
+    baseUrl: string;
+    databaseFingerprint: string;
+    startedAt: string;
+    capabilityToken: string;
+}
+export interface CreateRuntimeDescriptorInput {
+    databasePath: string;
+    baseUrl: string;
+    pid?: number;
+    instanceId?: string;
+    startedAt?: string;
+    capabilityToken?: string;
+}
+export declare function createRuntimeDescriptor(input: CreateRuntimeDescriptorInput): RuntimeDescriptor;
+export type RuntimeDescriptorView = Omit<RuntimeDescriptor, 'capabilityToken'>;
+export declare function toPublicRuntimeDescriptor(descriptor: RuntimeDescriptor): RuntimeDescriptorView;
+export declare function writeRuntimeDescriptor(filePath: string, descriptor: RuntimeDescriptor): Promise<void>;
+export declare function readRuntimeDescriptor(filePath: string): Promise<RuntimeDescriptor | undefined>;
+export declare function removeRuntimeDescriptor(filePath: string, expectedInstanceId: string): Promise<boolean>;
+//# sourceMappingURL=runtime-descriptor.d.ts.map

package/dist/server/runtime-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-descriptor.d.ts","sourceRoot":"","sources":["../../src/server/runtime-descriptor.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,GAAG,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,iBAAiB,CAa9F;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AAE/E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,qBAAqB,CAS9F;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3G;AAcD,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAapG;AAED,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK5G"}

package/dist/server/runtime-descriptor.js

@@ -0,0 +1,156 @@
+import { createHash, randomBytes, randomUUID } from 'node:crypto';
+import { chmod, lstat, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { KiokukoError } from '../errors.js';
+const DESCRIPTOR_FIELDS = new Set([
+    'protocolVersion',
+    'instanceId',
+    'pid',
+    'baseUrl',
+    'databaseFingerprint',
+    'startedAt',
+    'capabilityToken',
+]);
+function validation(field) {
+    throw new KiokukoError('VALIDATION_ERROR', `Invalid runtime descriptor field: ${field}`);
+}
+function isLoopbackHttpUrl(value) {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:'
+            && (url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]')
+            && url.username === ''
+            && url.password === ''
+            && url.search === ''
+            && url.hash === '';
+    }
+    catch {
+        return false;
+    }
+}
+function isCanonicalUtc(value) {
+    if (typeof value !== 'string')
+        return false;
+    const date = new Date(value);
+    return !Number.isNaN(date.getTime()) && date.toISOString() === value;
+}
+function validateDescriptor(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Runtime descriptor must be an object');
+    }
+    for (const field of Object.keys(value)) {
+        if (!DESCRIPTOR_FIELDS.has(field)) {
+            throw new KiokukoError('VALIDATION_ERROR', `Unknown runtime descriptor field: ${field}`);
+        }
+    }
+    const descriptor = value;
+    for (const field of DESCRIPTOR_FIELDS) {
+        if (!(field in descriptor))
+            validation(field);
+    }
+    if (descriptor.protocolVersion !== '1')
+        validation('protocolVersion');
+    if (typeof descriptor.instanceId !== 'string'
+        || descriptor.instanceId.length === 0
+        || descriptor.instanceId.length > 128
+        || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(descriptor.instanceId)) {
+        validation('instanceId');
+    }
+    if (typeof descriptor.pid !== 'number' || !Number.isInteger(descriptor.pid) || descriptor.pid <= 0) {
+        validation('pid');
+    }
+    if (!isLoopbackHttpUrl(descriptor.baseUrl))
+        validation('baseUrl');
+    if (typeof descriptor.databaseFingerprint !== 'string' || !/^sha256:[a-f0-9]{64}$/.test(descriptor.databaseFingerprint)) {
+        validation('databaseFingerprint');
+    }
+    if (!isCanonicalUtc(descriptor.startedAt))
+        validation('startedAt');
+    if (typeof descriptor.capabilityToken !== 'string' || !/^[a-f0-9]{64}$/.test(descriptor.capabilityToken)) {
+        validation('capabilityToken');
+    }
+    return descriptor;
+}
+export function createRuntimeDescriptor(input) {
+    const databaseFingerprint = createHash('sha256')
+        .update(path.resolve(input.databasePath), 'utf8')
+        .digest('hex');
+    return validateDescriptor({
+        protocolVersion: '1',
+        instanceId: input.instanceId ?? randomUUID(),
+        pid: input.pid ?? process.pid,
+        baseUrl: input.baseUrl,
+        databaseFingerprint: `sha256:${databaseFingerprint}`,
+        startedAt: input.startedAt ?? new Date().toISOString(),
+        capabilityToken: input.capabilityToken ?? randomBytes(32).toString('hex'),
+    });
+}
+export function toPublicRuntimeDescriptor(descriptor) {
+    return {
+        protocolVersion: descriptor.protocolVersion,
+        instanceId: descriptor.instanceId,
+        pid: descriptor.pid,
+        baseUrl: descriptor.baseUrl,
+        databaseFingerprint: descriptor.databaseFingerprint,
+        startedAt: descriptor.startedAt,
+    };
+}
+export async function writeRuntimeDescriptor(filePath, descriptor) {
+    validateDescriptor(descriptor);
+    try {
+        assertSecureDescriptorFile(await lstat(filePath));
+    }
+    catch (error) {
+        if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
+            throw error;
+        }
+    }
+    const directory = path.dirname(filePath);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const temporaryPath = path.join(directory, `.${path.basename(filePath)}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporaryPath, `${JSON.stringify(descriptor)}\n`, { encoding: 'utf8', mode: 0o600 });
+        await chmod(temporaryPath, 0o600);
+        await rename(temporaryPath, filePath);
+    }
+    catch (error) {
+        await unlink(temporaryPath).catch(() => undefined);
+        throw error;
+    }
+}
+function assertSecureDescriptorFile(info) {
+    if (info.isSymbolicLink()) {
+        throw new KiokukoError('SECURITY_REJECTION', 'Runtime descriptor must not be a symbolic link');
+    }
+    if (!info.isFile()) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Runtime descriptor must be a regular file');
+    }
+    if (process.platform !== 'win32' && (Number(info.mode) & 0o077) !== 0) {
+        throw new KiokukoError('SECURITY_REJECTION', 'Runtime descriptor permissions are too broad');
+    }
+}
+export async function readRuntimeDescriptor(filePath) {
+    try {
+        assertSecureDescriptorFile(await lstat(filePath));
+        return validateDescriptor(JSON.parse(await readFile(filePath, 'utf8')));
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return undefined;
+        }
+        if (error instanceof SyntaxError) {
+            throw new KiokukoError('VALIDATION_ERROR', 'Runtime descriptor JSON is invalid');
+        }
+        throw error;
+    }
+}
+export async function removeRuntimeDescriptor(filePath, expectedInstanceId) {
+    const descriptor = await readRuntimeDescriptor(filePath);
+    if (!descriptor || descriptor.instanceId !== expectedInstanceId)
+        return false;
+    await unlink(filePath);
+    return true;
+}
+//# sourceMappingURL=runtime-descriptor.js.map

package/dist/server/runtime-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-descriptor.js","sourceRoot":"","sources":["../../src/server/runtime-descriptor.ts"],"names":[],"mappings":"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"}

package/dist/server/write-queue.d.ts

@@ -0,0 +1,20 @@
+export interface WriteQueueState {
+    readonly accepting: boolean;
+    readonly running: boolean;
+    readonly waiting: number;
+}
+type WriteOperation<T> = () => T | PromiseLike<T>;
+export declare const WRITE_QUEUE_RETRY_AFTER_SECONDS = 1;
+export declare class WriteQueue<T> {
+    #private;
+    constructor(waitingCapacity: number);
+    get accepting(): boolean;
+    get running(): boolean;
+    get waiting(): number;
+    get state(): WriteQueueState;
+    enqueue(operation: WriteOperation<T>): Promise<T>;
+    close(): Promise<void>;
+    drain(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=write-queue.d.ts.map

package/dist/server/write-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-queue.d.ts","sourceRoot":"","sources":["../../src/server/write-queue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,cAAc,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAElD,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAQjD,qBAAa,UAAU,CAAC,CAAC;;gBAOX,eAAe,EAAE,MAAM;IAOnC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,KAAK,IAAI,eAAe,CAM3B;IAED,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkCvB"}

package/dist/server/write-queue.js

@@ -0,0 +1,83 @@
+import { KiokukoError } from '../errors.js';
+export const WRITE_QUEUE_RETRY_AFTER_SECONDS = 1;
+export class WriteQueue {
+    #waitingCapacity;
+    #items = [];
+    #accepting = true;
+    #running = false;
+    #drainWaiters = [];
+    constructor(waitingCapacity) {
+        if (!Number.isInteger(waitingCapacity) || waitingCapacity <= 0) {
+            throw new KiokukoError('VALIDATION_ERROR', 'waitingCapacity must be a positive integer');
+        }
+        this.#waitingCapacity = waitingCapacity;
+    }
+    get accepting() {
+        return this.#accepting;
+    }
+    get running() {
+        return this.#running;
+    }
+    get waiting() {
+        return this.#items.length;
+    }
+    get state() {
+        return {
+            accepting: this.#accepting,
+            running: this.#running,
+            waiting: this.#items.length,
+        };
+    }
+    enqueue(operation) {
+        if (!this.#accepting) {
+            return Promise.reject(new KiokukoError('SERVICE_UNAVAILABLE', 'Write queue is closed'));
+        }
+        if (this.#items.length >= this.#waitingCapacity) {
+            return Promise.reject(new KiokukoError('BACKPRESSURE', 'Write queue is at capacity', {
+                retryAfterSeconds: WRITE_QUEUE_RETRY_AFTER_SECONDS,
+            }));
+        }
+        return new Promise((resolve, reject) => {
+            this.#items.push({ operation, resolve, reject });
+            this.#startNext();
+        });
+    }
+    close() {
+        this.#accepting = false;
+        return this.drain();
+    }
+    drain() {
+        if (!this.#running && this.#items.length === 0)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            this.#drainWaiters.push(resolve);
+        });
+    }
+    #startNext() {
+        if (this.#running)
+            return;
+        const item = this.#items.shift();
+        if (item === undefined)
+            return;
+        this.#running = true;
+        void Promise.resolve()
+            .then(item.operation)
+            .then((value) => {
+            item.resolve(value);
+            this.#finishCurrent();
+        }, (error) => {
+            item.reject(error);
+            this.#finishCurrent();
+        });
+    }
+    #finishCurrent() {
+        this.#running = false;
+        this.#startNext();
+        if (this.#running || this.#items.length > 0)
+            return;
+        const waiters = this.#drainWaiters.splice(0);
+        for (const resolve of waiters)
+            resolve();
+    }
+}
+//# sourceMappingURL=write-queue.js.map

package/dist/server/write-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-queue.js","sourceRoot":"","sources":["../../src/server/write-queue.ts"],"names":[],"mappings":"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"}

package/dist/setup/claude-config.d.ts

@@ -0,0 +1,8 @@
+import type { SkillDiscoveryMode } from '../skills/types.js';
+import type { DelimitedBlockResult } from './managed-text.js';
+/** Detect an already managed Claude Kiokuko MCP identity without changing it. */
+export declare function hasCanonicalClaudeMcpConfig(existing: string | undefined): boolean;
+export declare function renderClaudeConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode, options?: {
+    replaceConflictingIdentity?: boolean;
+}): DelimitedBlockResult;
+//# sourceMappingURL=claude-config.d.ts.map

package/dist/setup/claude-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-config.d.ts","sourceRoot":"","sources":["../../src/setup/claude-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA8B9D,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAYjF;AAUD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,SAAY,EACnB,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,OAAO,GAAE;IAAE,0BAA0B,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,oBAAoB,CA8CtB"}

package/dist/setup/claude-config.js

@@ -0,0 +1,95 @@
+import { applyEdits, modify, parse } from 'jsonc-parser';
+import { KiokukoError } from '../errors.js';
+import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
+import { setupMcpIdentityConflict } from './mcp-conflict.js';
+import { assertStrictJsonSyntax } from './strict-json.js';
+function object(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function hasExactKeys(value, expected) {
+    const keys = Object.keys(value);
+    return keys.length === expected.length && expected.every((key) => keys.includes(key));
+}
+function isNonEmptyCommand(value) {
+    return typeof value === 'string' && value.trim().length > 0 && !value.includes('\0');
+}
+function isCanonicalManagedServer(value) {
+    const server = object(value);
+    if (server === undefined || !hasExactKeys(server, ['type', 'command', 'args', 'env']))
+        return false;
+    if (server.type !== 'stdio' || !isNonEmptyCommand(server.command))
+        return false;
+    if (!Array.isArray(server.args) || server.args.length !== 1 || server.args[0] !== 'mcp')
+        return false;
+    const environment = object(server.env);
+    return environment !== undefined
+        && hasExactKeys(environment, [SKILL_DISCOVERY_ENV])
+        && isSkillDiscoveryMode(environment[SKILL_DISCOVERY_ENV]);
+}
+/** Detect an already managed Claude Kiokuko MCP identity without changing it. */
+export function hasCanonicalClaudeMcpConfig(existing) {
+    if (existing === undefined)
+        return false;
+    assertStrictJsonSyntax(existing, { allowTrailingComma: false, disallowComments: true }, 'Claude user config is not a valid JSON object with unique keys');
+    const errors = [];
+    const parsed = parse(existing, errors, { allowTrailingComma: false, disallowComments: true });
+    const root = object(parsed);
+    if (errors.length > 0 || root === undefined)
+        return false;
+    return isCanonicalManagedServer(object(root.mcpServers)?.kiokuko);
+}
+function validation(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function conflict() {
+    setupMcpIdentityConflict('claude', 'Claude user config already contains a conflicting kiokuko MCP server');
+}
+export function renderClaudeConfig(existing, command = 'kiokuko', skillDiscoveryMode, options = {}) {
+    if (!isNonEmptyCommand(command))
+        validation('Claude MCP command must be a non-empty executable path or name');
+    if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
+        validation('Claude Skill discovery mode is invalid');
+    }
+    if (options.replaceConflictingIdentity !== undefined
+        && typeof options.replaceConflictingIdentity !== 'boolean') {
+        validation('Claude MCP replacement authorization is invalid');
+    }
+    const source = existing ?? '{}\n';
+    assertStrictJsonSyntax(source, { allowTrailingComma: false, disallowComments: true }, 'Claude user config is not a valid JSON object with unique keys');
+    const errors = [];
+    const parsed = parse(source, errors, { allowTrailingComma: false, disallowComments: true });
+    if (errors.length > 0 || typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        validation('Claude user config is not a valid JSON object');
+    }
+    const root = parsed;
+    const mcpServers = object(root.mcpServers);
+    if (root.mcpServers !== undefined && mcpServers === undefined)
+        validation('Claude user config has an invalid mcpServers object');
+    const currentServer = mcpServers?.kiokuko;
+    const canonicalServer = currentServer !== undefined && isCanonicalManagedServer(currentServer)
+        ? currentServer
+        : undefined;
+    if (currentServer !== undefined && canonicalServer === undefined && !options.replaceConflictingIdentity)
+        conflict();
+    const currentEnvironment = canonicalServer === undefined ? undefined : object(canonicalServer.env);
+    const effectiveSkillDiscoveryMode = skillDiscoveryMode
+        ?? currentEnvironment?.[SKILL_DISCOVERY_ENV]
+        ?? 'official';
+    const eol = source.includes('\r\n') ? '\r\n' : '\n';
+    const edits = modify(source, ['mcpServers', 'kiokuko'], {
+        type: 'stdio',
+        command,
+        args: ['mcp'],
+        env: { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode },
+    }, {
+        formattingOptions: { insertSpaces: true, tabSize: 2, eol },
+    });
+    const content = applyEdits(source, edits);
+    return {
+        content,
+        action: existing === undefined ? 'created' : content === existing ? 'unchanged' : 'updated',
+    };
+}
+//# sourceMappingURL=claude-config.js.map