@timurproko/a1 0.1.0

package/dist/src/foundation/structured-agent-runtime/backpressure.js

@@ -0,0 +1,119 @@
+import { assertStructuredCapability, } from "../workspace-contracts/index.js";
+export class StructuredBackpressureController {
+    adapterId;
+    #budgets;
+    #usage = {
+        events: { units: 0, bytes: 0 },
+        commands: { units: 0, bytes: 0 },
+        snapshots: { units: 0, bytes: 0 },
+        attachments: { units: 0, bytes: 0 },
+        "reconnect-replay": { units: 0, bytes: 0 },
+    };
+    #leases = new Map();
+    #nextLeaseSequence = 0;
+    #replayExhausted = false;
+    constructor(adapterId, capability) {
+        this.adapterId = adapterId;
+        assertStructuredCapability(capability);
+        if (!adapterId || adapterId !== capability.adapterId)
+            throw new TypeError("structured backpressure adapter identity is invalid");
+        this.#budgets = Object.freeze({
+            events: budget(capability.flow.maxQueuedEvents, capability.flow.maxQueuedEvents * capability.flow.maxEventBytes, capability.flow.maxEventBytes, "pause-adapter"),
+            commands: budget(capability.flow.maxConcurrentCommands, capability.flow.maxConcurrentCommands * capability.flow.maxEventBytes, capability.flow.maxEventBytes, "reject-request"),
+            snapshots: budget(1, capability.flow.maxSnapshotBytes, capability.flow.maxSnapshotBytes, "reject-request"),
+            attachments: budget(capability.flow.maxConcurrentCommands, capability.flow.maxAttachmentBytes, capability.flow.maxAttachmentBytes, "reject-request"),
+            "reconnect-replay": budget(capability.flow.maxReconnectEvents, capability.flow.maxReconnectEvents * capability.flow.maxEventBytes, capability.flow.maxEventBytes, "disconnect-adapter"),
+        });
+    }
+    acquire(resource, units = 1, bytes = 0) {
+        const budget = this.#budget(resource);
+        if (!isPositiveSafeInteger(units) || !isSafeNonNegativeInteger(bytes)) {
+            return this.#reject(resource, "invalid-request", "reject-request", "resource units and bytes must be bounded safe integers");
+        }
+        if (bytes > budget.perPayloadByteLimit) {
+            return this.#reject(resource, "payload-too-large", "reject-payload", `${resource} payload exceeds its negotiated ${budget.perPayloadByteLimit} byte limit`);
+        }
+        if (resource === "reconnect-replay" && this.#replayExhausted) {
+            return this.#reject(resource, "replay-exhausted", "disconnect-adapter", "reconnect replay is already exhausted for this adapter");
+        }
+        const usage = this.#usage[resource];
+        if (usage.units + units > budget.unitLimit || usage.bytes + bytes > budget.byteLimit) {
+            if (resource === "reconnect-replay") {
+                this.#replayExhausted = true;
+                return this.#reject(resource, "replay-exhausted", "disconnect-adapter", "reconnect replay exceeded its negotiated event or byte window");
+            }
+            return this.#reject(resource, "resource-exhausted", budget.action, `${resource} exceeded its negotiated count or byte window`);
+        }
+        usage.units += units;
+        usage.bytes += bytes;
+        this.#nextLeaseSequence += 1;
+        const lease = Object.freeze({
+            id: `lease-${this.adapterId}-${this.#nextLeaseSequence}`,
+            resource,
+            units,
+            bytes,
+        });
+        this.#leases.set(lease.id, lease);
+        return { kind: "accepted", lease, usage: this.usage(resource) };
+    }
+    release(lease) {
+        if (!lease || typeof lease.id !== "string" || !isPositiveSafeInteger(lease.units) || !isSafeNonNegativeInteger(lease.bytes)) {
+            return { kind: "rejected", code: "invalid-request", diagnostic: "resource lease is malformed" };
+        }
+        const owned = this.#leases.get(lease.id);
+        if (!owned || owned.resource !== lease.resource || owned.units !== lease.units || owned.bytes !== lease.bytes) {
+            return { kind: "rejected", code: "unknown-lease", diagnostic: `resource lease is unknown: ${lease.id}` };
+        }
+        this.#leases.delete(lease.id);
+        const usage = this.#usage[lease.resource];
+        usage.units -= lease.units;
+        usage.bytes -= lease.bytes;
+        return { kind: "released", usage: this.usage(lease.resource) };
+    }
+    resetReconnectReplay() {
+        const usage = this.#usage["reconnect-replay"];
+        usage.units = 0;
+        usage.bytes = 0;
+        this.#replayExhausted = false;
+        for (const [id, lease] of this.#leases) {
+            if (lease.resource === "reconnect-replay")
+                this.#leases.delete(id);
+        }
+    }
+    usage(resource) {
+        const usage = this.#usage[resource];
+        const budget = this.#budget(resource);
+        return Object.freeze({
+            resource,
+            units: usage.units,
+            bytes: usage.bytes,
+            unitLimit: budget.unitLimit,
+            byteLimit: budget.byteLimit,
+        });
+    }
+    leaseCount() {
+        return this.#leases.size;
+    }
+    replayExhausted() {
+        return this.#replayExhausted;
+    }
+    #budget(resource) {
+        const budget = this.#budgets[resource];
+        if (!budget)
+            throw new TypeError(`unknown structured backpressure resource: ${String(resource)}`);
+        return budget;
+    }
+    #reject(resource, code, action, diagnostic) {
+        return { kind: "rejected", code, action, usage: this.usage(resource), diagnostic };
+    }
+}
+function budget(unitLimit, byteLimit, perPayloadByteLimit, action) {
+    return Object.freeze({ unitLimit, byteLimit, perPayloadByteLimit, action });
+}
+function isPositiveSafeInteger(value) {
+    return Number.isSafeInteger(value) && value > 0;
+}
+function isSafeNonNegativeInteger(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+//# sourceMappingURL=backpressure.js.map

package/dist/src/foundation/structured-agent-runtime/backpressure.js.map

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

package/dist/src/foundation/structured-agent-runtime/commands.d.ts

@@ -0,0 +1,53 @@
+import { type StructuredCapabilityContract, type WorkspaceCommand } from "../workspace-contracts/index.js";
+export type StructuredCommandRequest = Extract<WorkspaceCommand, {
+    readonly type: "structured-command";
+}>;
+export type StructuredCancelRequest = Extract<WorkspaceCommand, {
+    readonly type: "cancel-structured-command";
+}>;
+export type StructuredCommandTerminalOutcome = "completed" | "failed" | "timed-out" | "cancelled";
+export interface StructuredCommandRecord {
+    readonly agentId: string;
+    readonly correlationId: string;
+    readonly command: string;
+    readonly payload: unknown;
+    readonly startedAt: number;
+    readonly terminalAt: number | null;
+    readonly outcome: "active" | StructuredCommandTerminalOutcome;
+    readonly revision: number;
+}
+export type StructuredCommandStartResult = {
+    readonly kind: "accepted";
+    readonly record: StructuredCommandRecord;
+    readonly activeCount: number;
+} | {
+    readonly kind: "outcome";
+    readonly record: StructuredCommandRecord;
+    readonly idempotent: true;
+} | {
+    readonly kind: "rejected";
+    readonly code: string;
+    readonly diagnostic: string;
+};
+export type StructuredCommandOutcomeResult = {
+    readonly kind: "outcome";
+    readonly record: StructuredCommandRecord;
+    readonly idempotent: boolean;
+} | {
+    readonly kind: "rejected";
+    readonly code: string;
+    readonly diagnostic: string;
+};
+export declare class StructuredCommandTracker {
+    #private;
+    readonly agentId: string;
+    constructor(agentId: string, capability: StructuredCapabilityContract, commandTimeoutMs?: number);
+    start(command: StructuredCommandRequest, startedAt?: number): StructuredCommandStartResult;
+    complete(correlationId: string, outcome: "completed" | "failed", completedAt?: number): StructuredCommandOutcomeResult;
+    cancel(request: StructuredCancelRequest, cancelledAt?: number): StructuredCommandOutcomeResult;
+    expire(now: number): readonly StructuredCommandRecord[];
+    outcomeFor(correlationId: string): StructuredCommandRecord | null;
+    activeCount(): number;
+    terminalCount(): number;
+}
+//# sourceMappingURL=commands.d.ts.map

package/dist/src/foundation/structured-agent-runtime/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/foundation/structured-agent-runtime/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAAC;AAC1G,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;CAAE,CAAC,CAAC;AAChH,MAAM,MAAM,gCAAgC,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAElG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,gCAAgC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAAE,GACjG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,8BAA8B,GACtC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACpG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAatF,qBAAa,wBAAwB;;IAOjC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EACxB,UAAU,EAAE,4BAA4B,EACxC,gBAAgB,SAAS;IAS3B,KAAK,CAAC,OAAO,EAAE,wBAAwB,EAAE,SAAS,SAAI,GAAG,4BAA4B;IA4CrF,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,QAAQ,EAAE,WAAW,SAAI,GAAG,8BAA8B;IAYjH,MAAM,CAAC,OAAO,EAAE,uBAAuB,EAAE,WAAW,SAAI,GAAG,8BAA8B;IAkBzF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,uBAAuB,EAAE;IAYvD,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAKjE,WAAW,IAAI,MAAM;IAMrB,aAAa,IAAI,MAAM;CAuBxB"}

package/dist/src/foundation/structured-agent-runtime/commands.js

@@ -0,0 +1,165 @@
+import { assertStructuredCapability, assertWorkspaceCommand, } from "../workspace-contracts/index.js";
+export class StructuredCommandTracker {
+    agentId;
+    #capability;
+    #commandTimeoutMs;
+    #records = new Map();
+    #terminalOrder = [];
+    constructor(agentId, capability, commandTimeoutMs = 30_000) {
+        this.agentId = agentId;
+        assertStructuredCapability(capability);
+        if (!agentId || agentId.includes("\0"))
+            throw new TypeError("structured command agent id is invalid");
+        if (!Number.isSafeInteger(commandTimeoutMs) || commandTimeoutMs <= 0)
+            throw new RangeError("structured command timeout must be positive");
+        this.#capability = capability;
+        this.#commandTimeoutMs = commandTimeoutMs;
+    }
+    start(command, startedAt = 0) {
+        try {
+            assertWorkspaceCommand(command);
+        }
+        catch (error) {
+            return rejected("malformed-command", error);
+        }
+        if (command.agentId !== this.agentId)
+            return rejected("agent-mismatch", new Error("structured command agent does not match the tracker identity"));
+        if (!this.#capability.commands.includes(command.command)) {
+            return rejected("unsupported-command", new Error(`structured command is not negotiated: ${command.command}`));
+        }
+        if (payloadBytes(command.payload) > this.#capability.flow.maxEventBytes) {
+            return rejected("command-too-large", new Error(`structured command exceeds the negotiated ${this.#capability.flow.maxEventBytes} byte payload limit`));
+        }
+        try {
+            assertTime(startedAt, "command start time");
+        }
+        catch (error) {
+            return rejected("invalid-time", error);
+        }
+        const existing = this.#records.get(command.correlationId);
+        if (existing) {
+            if (existing.outcome !== "active" && existing.command === command.command && stableJson(existing.payload) === stableJson(command.payload)) {
+                return { kind: "outcome", record: freezeRecord(existing), idempotent: true };
+            }
+            return rejected(existing.outcome === "active" ? "duplicate-correlation" : "correlation-conflict", new Error(`structured correlation id is already in use: ${command.correlationId}`));
+        }
+        if (this.activeCount() >= this.#capability.flow.maxConcurrentCommands) {
+            return rejected("concurrency-limit", new Error(`structured command concurrency exceeds the negotiated ${this.#capability.flow.maxConcurrentCommands} command limit`));
+        }
+        const record = {
+            agentId: command.agentId,
+            correlationId: command.correlationId,
+            command: command.command,
+            payload: command.payload,
+            startedAt,
+            terminalAt: null,
+            outcome: "active",
+            revision: 1,
+        };
+        this.#records.set(record.correlationId, record);
+        return { kind: "accepted", record: freezeRecord(record), activeCount: this.activeCount() };
+    }
+    complete(correlationId, outcome, completedAt = 0) {
+        if (outcome !== "completed" && outcome !== "failed")
+            return rejected("malformed-outcome", new Error("structured completion outcome is invalid"));
+        try {
+            assertTime(completedAt, "command completion time");
+        }
+        catch (error) {
+            return rejected("invalid-time", error);
+        }
+        const record = this.#records.get(correlationId);
+        if (!record)
+            return rejected("unknown-correlation", new Error(`structured correlation id is unknown: ${correlationId}`));
+        return this.#settle(record, outcome, completedAt);
+    }
+    cancel(request, cancelledAt = 0) {
+        try {
+            assertWorkspaceCommand(request);
+        }
+        catch (error) {
+            return rejected("malformed-cancellation", error);
+        }
+        if (request.agentId !== this.agentId)
+            return rejected("agent-mismatch", new Error("structured cancellation agent does not match the tracker identity"));
+        if (this.#capability.cancellation !== "correlated")
+            return rejected("cancellation-unsupported", new Error("the negotiated adapter capability does not support correlated cancellation"));
+        try {
+            assertTime(cancelledAt, "command cancellation time");
+        }
+        catch (error) {
+            return rejected("invalid-time", error);
+        }
+        const record = this.#records.get(request.targetCorrelationId);
+        if (!record)
+            return rejected("unknown-correlation", new Error(`structured correlation id is unknown: ${request.targetCorrelationId}`));
+        return this.#settle(record, "cancelled", cancelledAt);
+    }
+    expire(now) {
+        assertTime(now, "command timeout clock");
+        const expired = [];
+        for (const record of this.#records.values()) {
+            if (record.outcome === "active" && now - record.startedAt >= this.#commandTimeoutMs) {
+                const result = this.#settle(record, "timed-out", record.startedAt + this.#commandTimeoutMs);
+                if (result.kind === "outcome")
+                    expired.push(result.record);
+            }
+        }
+        return Object.freeze(expired);
+    }
+    outcomeFor(correlationId) {
+        const record = this.#records.get(correlationId);
+        return record ? freezeRecord(record) : null;
+    }
+    activeCount() {
+        let count = 0;
+        for (const record of this.#records.values())
+            if (record.outcome === "active")
+                count += 1;
+        return count;
+    }
+    terminalCount() {
+        return this.#terminalOrder.length;
+    }
+    #settle(record, outcome, at) {
+        if (record.outcome !== "active")
+            return { kind: "outcome", record: freezeRecord(record), idempotent: true };
+        if (at < record.startedAt)
+            return rejected("invalid-time", new Error("structured command outcome cannot precede its start"));
+        record.outcome = outcome;
+        record.terminalAt = at;
+        record.revision += 1;
+        this.#terminalOrder.push(record.correlationId);
+        this.#boundTerminalOutcomes();
+        return { kind: "outcome", record: freezeRecord(record), idempotent: false };
+    }
+    #boundTerminalOutcomes() {
+        const retention = this.#capability.flow.maxQueuedEvents;
+        while (this.#terminalOrder.length > retention) {
+            const oldest = this.#terminalOrder.shift();
+            if (oldest === undefined)
+                return;
+            this.#records.delete(oldest);
+        }
+    }
+}
+function rejected(code, error) {
+    return { kind: "rejected", code, diagnostic: error instanceof Error ? error.message : String(error) };
+}
+function freezeRecord(record) {
+    return Object.freeze({ ...record });
+}
+function assertTime(value, name) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new RangeError(`${name} must be a non-negative safe integer`);
+}
+function payloadBytes(payload) {
+    return new TextEncoder().encode(stableJson(payload)).byteLength;
+}
+function stableJson(value) {
+    const encoded = JSON.stringify(value);
+    if (encoded === undefined)
+        throw new TypeError("structured payload must be JSON serializable");
+    return encoded;
+}
+//# sourceMappingURL=commands.js.map

package/dist/src/foundation/structured-agent-runtime/commands.js.map

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

package/dist/src/foundation/structured-agent-runtime/handshake.d.ts

@@ -0,0 +1,42 @@
+import { type AdapterId, type StructuredCapabilityContract, type StructuredFlowLimits } from "../workspace-contracts/index.js";
+export declare const STRUCTURED_ADAPTER_ENVELOPE: "addone-structured-adapter";
+export declare const STRUCTURED_ADAPTER_ENVELOPE_REVISION: 1;
+export declare const REQUIRED_STRUCTURED_FEATURES: readonly ["identity.adapter.v1", "commands.correlated.v1", "events.typed.v1", "flow-control.limits.v1"];
+export declare const OPTIONAL_STRUCTURED_FEATURES: readonly ["snapshots.authoritative.v1", "resume.position.v1", "resume.snapshot.v1", "commands.cancellable.v1", "attachments.typed.v1"];
+export type StructuredProtocolFeature = typeof REQUIRED_STRUCTURED_FEATURES[number] | typeof OPTIONAL_STRUCTURED_FEATURES[number];
+export declare const ADDONE_STRUCTURED_FLOW_LIMITS: StructuredFlowLimits;
+export interface StructuredAdapterHello {
+    readonly envelope: typeof STRUCTURED_ADAPTER_ENVELOPE;
+    readonly envelopeRevision: typeof STRUCTURED_ADAPTER_ENVELOPE_REVISION;
+    readonly adapterId: AdapterId;
+    readonly buildId: string;
+    readonly requiredFeatures: readonly string[];
+    readonly optionalFeatures: readonly string[];
+    readonly capability: StructuredCapabilityContract;
+}
+export interface StructuredAdapterPeerHello {
+    readonly envelope: typeof STRUCTURED_ADAPTER_ENVELOPE;
+    readonly envelopeRevision: typeof STRUCTURED_ADAPTER_ENVELOPE_REVISION;
+    readonly requiredFeatures: readonly string[];
+    readonly optionalFeatures: readonly string[];
+    readonly flowLimits: StructuredFlowLimits;
+}
+export type StructuredHandshakeErrorCode = "invalid-message" | "unsupported-version" | "invalid-identity" | "invalid-capability" | "unsupported-feature" | "incompatible-features";
+export interface StructuredHandshakeAccepted {
+    readonly accepted: true;
+    readonly adapterId: AdapterId;
+    readonly negotiatedFeatures: readonly string[];
+    readonly capability: StructuredCapabilityContract;
+    readonly diagnostic: string;
+}
+export interface StructuredHandshakeRejected {
+    readonly accepted: false;
+    readonly code: StructuredHandshakeErrorCode;
+    readonly missingFromAdapter: readonly string[];
+    readonly missingFromServer: readonly string[];
+    readonly diagnostic: string;
+}
+export type StructuredHandshakeResult = StructuredHandshakeAccepted | StructuredHandshakeRejected;
+export declare function localStructuredAdapterHello(): StructuredAdapterPeerHello;
+export declare function negotiateStructuredAdapter(value: unknown, server?: StructuredAdapterPeerHello): StructuredHandshakeResult;
+//# sourceMappingURL=handshake.d.ts.map

package/dist/src/foundation/structured-agent-runtime/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../../../src/foundation/structured-agent-runtime/handshake.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AAEzC,eAAO,MAAM,2BAA2B,EAAG,2BAAoC,CAAC;AAChF,eAAO,MAAM,oCAAoC,EAAG,CAAU,CAAC;AAC/D,eAAO,MAAM,4BAA4B,yGAK/B,CAAC;AACX,eAAO,MAAM,4BAA4B,wIAM/B,CAAC;AACX,MAAM,MAAM,yBAAyB,GAAG,OAAO,4BAA4B,CAAC,MAAM,CAAC,GAAG,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAElI,eAAO,MAAM,6BAA6B,EAAE,oBAO1C,CAAC;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IACtD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,oCAAoC,CAAC;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;CACnD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IACtD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,oCAAoC,CAAC;IACvE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;CAC3C;AAED,MAAM,MAAM,4BAA4B,GACpC,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,yBAAyB,GAAG,2BAA2B,GAAG,2BAA2B,CAAC;AAElG,wBAAgB,2BAA2B,IAAI,0BAA0B,CAQxE;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,0BAA0D,GACjE,yBAAyB,CAwE3B"}

package/dist/src/foundation/structured-agent-runtime/handshake.js

@@ -0,0 +1,151 @@
+import { WORKSPACE_CONTRACT_VERSION, assertStructuredCapability, } from "../workspace-contracts/index.js";
+export const STRUCTURED_ADAPTER_ENVELOPE = "addone-structured-adapter";
+export const STRUCTURED_ADAPTER_ENVELOPE_REVISION = 1;
+export const REQUIRED_STRUCTURED_FEATURES = [
+    "identity.adapter.v1",
+    "commands.correlated.v1",
+    "events.typed.v1",
+    "flow-control.limits.v1",
+];
+export const OPTIONAL_STRUCTURED_FEATURES = [
+    "snapshots.authoritative.v1",
+    "resume.position.v1",
+    "resume.snapshot.v1",
+    "commands.cancellable.v1",
+    "attachments.typed.v1",
+];
+export const ADDONE_STRUCTURED_FLOW_LIMITS = Object.freeze({
+    maxEventBytes: 64 * 1024,
+    maxSnapshotBytes: 1024 * 1024,
+    maxAttachmentBytes: 2 * 1024 * 1024,
+    maxQueuedEvents: 256,
+    maxConcurrentCommands: 4,
+    maxReconnectEvents: 1024,
+});
+export function localStructuredAdapterHello() {
+    return {
+        envelope: STRUCTURED_ADAPTER_ENVELOPE,
+        envelopeRevision: STRUCTURED_ADAPTER_ENVELOPE_REVISION,
+        requiredFeatures: REQUIRED_STRUCTURED_FEATURES,
+        optionalFeatures: OPTIONAL_STRUCTURED_FEATURES,
+        flowLimits: ADDONE_STRUCTURED_FLOW_LIMITS,
+    };
+}
+export function negotiateStructuredAdapter(value, server = localStructuredAdapterHello()) {
+    if (!isStructuredAdapterHello(value)) {
+        return reject("invalid-message", [], [], "adapter hello is malformed or omits required identity, feature, or capability fields");
+    }
+    if (value.envelope !== server.envelope || value.envelopeRevision !== server.envelopeRevision) {
+        return reject("unsupported-version", [], [], `structured adapter envelope mismatch: adapter ${String(value.envelope)}/${String(value.envelopeRevision)}; AddOne ${server.envelope}/${server.envelopeRevision}`);
+    }
+    if (!isValidIdentityText(value.adapterId) || !isValidBuildId(value.buildId)) {
+        return reject("invalid-identity", [], [], "adapter identity and build identity must be bounded non-empty values");
+    }
+    if (value.capability.adapterId !== value.adapterId) {
+        return reject("invalid-identity", [], [], "adapter capability identity must match the hello identity");
+    }
+    try {
+        assertStructuredCapability(value.capability);
+    }
+    catch (error) {
+        return reject("invalid-capability", [], [], `adapter capability is invalid: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const advertised = featureSet(value.requiredFeatures, value.optionalFeatures);
+    if (advertised.error)
+        return advertised.error;
+    const serverFeatures = new Set([...server.requiredFeatures, ...server.optionalFeatures]);
+    const adapterRequired = new Set(value.requiredFeatures);
+    const unknownRequired = [...adapterRequired].filter(feature => !serverFeatures.has(feature));
+    if (unknownRequired.length > 0) {
+        return reject("unsupported-feature", [], unknownRequired.sort(), `adapter requires unsupported structured features: ${unknownRequired.sort().join(", ")}`);
+    }
+    const missingFromAdapter = server.requiredFeatures.filter(feature => !advertised.features.has(feature)).sort();
+    const missingFromServer = [...adapterRequired].filter(feature => !serverFeatures.has(feature)).sort();
+    if (missingFromAdapter.length > 0 || missingFromServer.length > 0) {
+        return reject("incompatible-features", missingFromAdapter, missingFromServer, `required structured features are unavailable; adapter missing [${missingFromAdapter.join(", ")}], AddOne missing [${missingFromServer.join(", ")}]`);
+    }
+    const capabilityFeatures = requiredFeaturesForCapability(value.capability);
+    const undeclared = capabilityFeatures.filter(feature => !advertised.features.has(feature));
+    if (undeclared.length > 0) {
+        return reject("invalid-capability", undeclared.sort(), [], `adapter capability requires undeclared features: ${undeclared.sort().join(", ")}`);
+    }
+    const negotiatedFeatures = [...advertised.features].filter(feature => serverFeatures.has(feature)).sort();
+    const capability = {
+        ...value.capability,
+        adapterId: value.adapterId,
+        flow: negotiateFlow(value.capability.flow, server.flowLimits),
+    };
+    return {
+        accepted: true,
+        adapterId: value.adapterId,
+        negotiatedFeatures,
+        capability,
+        diagnostic: `structured adapter ready; negotiated ${negotiatedFeatures.join(", ")}`,
+    };
+}
+function requiredFeaturesForCapability(capability) {
+    const features = [];
+    if (capability.snapshots === "authoritative")
+        features.push("snapshots.authoritative.v1");
+    if (capability.resume === "position")
+        features.push("resume.position.v1");
+    if (capability.resume === "snapshot")
+        features.push("resume.snapshot.v1");
+    if (capability.cancellation === "correlated")
+        features.push("commands.cancellable.v1");
+    if (capability.attachmentTypes.length > 0)
+        features.push("attachments.typed.v1");
+    return features;
+}
+function negotiateFlow(adapter, addone) {
+    return Object.freeze({
+        maxEventBytes: Math.min(adapter.maxEventBytes, addone.maxEventBytes),
+        maxSnapshotBytes: Math.min(adapter.maxSnapshotBytes, addone.maxSnapshotBytes),
+        maxAttachmentBytes: Math.min(adapter.maxAttachmentBytes, addone.maxAttachmentBytes),
+        maxQueuedEvents: Math.min(adapter.maxQueuedEvents, addone.maxQueuedEvents),
+        maxConcurrentCommands: Math.min(adapter.maxConcurrentCommands, addone.maxConcurrentCommands),
+        maxReconnectEvents: Math.min(adapter.maxReconnectEvents, addone.maxReconnectEvents),
+    });
+}
+function isStructuredAdapterHello(value) {
+    if (!isRecord(value))
+        return false;
+    return typeof value.envelope === "string"
+        && typeof value.envelopeRevision === "number"
+        && typeof value.adapterId === "string"
+        && typeof value.buildId === "string"
+        && isStringArray(value.requiredFeatures)
+        && isStringArray(value.optionalFeatures)
+        && isRecord(value.capability)
+        && value.capability.kind === "structured"
+        && typeof value.capability.protocolVersion === "number";
+}
+function featureSet(required, optional) {
+    const features = new Set();
+    for (const feature of [...required, ...optional]) {
+        if (!isValidIdentityText(feature)) {
+            return { features, error: reject("invalid-message", [], [], `structured feature name is invalid: ${feature}`) };
+        }
+        if (features.has(feature)) {
+            return { features, error: reject("invalid-message", [], [], `structured feature is declared more than once: ${feature}`) };
+        }
+        features.add(feature);
+    }
+    return { features, error: null };
+}
+function reject(code, missingFromAdapter, missingFromServer, diagnostic) {
+    return { accepted: false, code, missingFromAdapter, missingFromServer, diagnostic };
+}
+function isValidIdentityText(value) {
+    return value.length > 0 && value.length <= 128 && !value.includes("\0");
+}
+function isValidBuildId(value) {
+    return value.length > 0 && value.length <= 256 && !value.includes("\0");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(item => typeof item === "string");
+}
+//# sourceMappingURL=handshake.js.map

package/dist/src/foundation/structured-agent-runtime/handshake.js.map

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

package/dist/src/foundation/structured-agent-runtime/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./backpressure.js";
+export * from "./commands.js";
+export * from "./handshake.js";
+export * from "./reconnection.js";
+export * from "./state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/structured-agent-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/structured-agent-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/src/foundation/structured-agent-runtime/index.js

@@ -0,0 +1,6 @@
+export * from "./backpressure.js";
+export * from "./commands.js";
+export * from "./handshake.js";
+export * from "./reconnection.js";
+export * from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/structured-agent-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/structured-agent-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}