@byok-sdk/client 0.7.0 → 0.8.0

package/dist/agent-home.d.ts

@@ -1,7 +1,8 @@
-import { type AgentRef } from '@byok-sdk/protocol';
+import { type AgentHomeProjectionOutcome, type AgentHomeProjectionPayload, type AgentRef } from '@byok-sdk/protocol';
 export type { AgentRef } from '@byok-sdk/protocol';
 export declare const AGENT_HOME_DIRECTORY = "agents";
 export declare const AGENT_HOME_INTERNAL_DIRECTORY = ".byok";
+export declare const AGENT_HOME_PROJECTION_STATE_FILE = "agent-home-projection.json";
 export declare class AgentHomeError extends Error {
     constructor(message: string);
 }
@@ -34,15 +35,24 @@ export interface AgentHomeResolution {
 export interface AgentHomeProjectionInput extends AgentHomeResolution {
     readonly cwd: string;
 }
+export interface AgentHomeProjectionApplyInput extends AgentHomeProjectionInput {
+    readonly requestId: string;
+    readonly projectionHash: string;
+    readonly projection: unknown;
+}
 /**
  * Optional downstream projection hook. The SDK supplies the canonical home;
  * the host supplies opaque, redacted product content and never joins
  * `agents/<agentId>` itself. The SDK does not parse the projected content.
  */
 export interface AgentHomeProjection {
-    prepare(input: AgentHomeProjectionInput): void | Promise<void>;
+    /** Optional creation/task-time host preparation retained as a distinct lifecycle. */
+    prepare?(input: AgentHomeProjectionInput): void | Promise<void>;
+    /** Task-free opaque projection consumer. Its successful return means its own bytes are durable. */
+    apply?(input: AgentHomeProjectionApplyInput): void | Promise<void>;
 }
 export type AgentHomeProjectionFunction = (input: AgentHomeProjectionInput) => void | Promise<void>;
+export type AgentHomeProjectionApplyFunction = (input: AgentHomeProjectionApplyInput) => void | Promise<void>;
 export interface AgentHomeLease {
     readonly leaseId: string;
     readonly agentRef: AgentRef;
@@ -102,5 +112,14 @@ export declare class AgentHomeManager {
     acquire(agentRef: AgentRef): Promise<AgentHomeBinding>;
     /** Initialize only after any requested session exact-match has succeeded. */
     initialize(binding: AgentHomeBinding): Promise<void>;
+    supportsTaskFreeProjection(): boolean;
+    /**
+     * Apply one task-free projection under the same canonical-home writer lease
+     * used by Agent execution. Only a successful host hook followed by the
+     * SDK-owned fsynced ordering record can return `applied`.
+     */
+    project(input: AgentHomeProjectionPayload): Promise<AgentHomeProjectionOutcome>;
 }
 export declare function createAgentHomeProjection(prepare: AgentHomeProjectionFunction): AgentHomeProjection;
+/** Create only the task-free opaque projection consumer; no task-time fallback is inferred. */
+export declare function createAgentHomeProjectionConsumer(apply: AgentHomeProjectionApplyFunction): AgentHomeProjection;