@openagentpack/sdk 0.1.0 → 0.2.0-beta.0

package/dist/{chunk-7ECSYAQA.js → chunk-CHGDM6TX.js}

@@ -4,16 +4,6 @@ var SCAN_FILE_TIMEOUT_MS = 12e4;
 var SCAN_POLL_INTERVAL_MS = 8e3;
 var SKILL_SCAN_BACKOFF = { initial: 2e3, factor: 2, max: 8e3 };
 var FILE_SCAN_BACKOFF = { initial: 1e3, factor: 1.5, max: 4e3 };
-var SKILL_STATUS_CODE = { checking: 0, active: 1, rejected: 2, deleted: 100 };
-var CODE_TO_SKILL_STATUS = {
-  0: "checking",
-  1: "active",
-  2: "rejected",
-  100: "deleted"
-};
-function skillStatusFromCode(code) {
-  return (code != null ? CODE_TO_SKILL_STATUS[code] : void 0) ?? "checking";
-}
 function skillStatusFromString(raw) {
   switch (String(raw ?? "").toLowerCase()) {
     case "active":
@@ -63,8 +53,6 @@ export {
   SCAN_POLL_INTERVAL_MS,
   SKILL_SCAN_BACKOFF,
   FILE_SCAN_BACKOFF,
-  SKILL_STATUS_CODE,
-  skillStatusFromCode,
   skillStatusFromString,
   classifyFileScan,
   classifySkillScan,

package/dist/{chunk-TUW6XLDT.js → chunk-OUHQYIG4.js}

@@ -1,6 +1,6 @@
 import {
   classifyFileScan
-} from "./chunk-7ECSYAQA.js";
+} from "./chunk-CHGDM6TX.js";
 
 // src/file-lifecycle.ts
 var BAILIAN_PROFILE = {

package/dist/file-lifecycle.js

@@ -4,8 +4,8 @@ import {
   enrichProviderFileInfo,
   needsFileStatusPoll,
   normalizeWireFileStatus
-} from "./chunk-TUW6XLDT.js";
-import "./chunk-7ECSYAQA.js";
+} from "./chunk-OUHQYIG4.js";
+import "./chunk-CHGDM6TX.js";
 export {
   defaultFileUploadPurpose,
   enrichFileMetadata,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ResourceAddress, a as ResourceType, C as CloudAgent, b as CloudEnvironment, c as CloudVault, E as EventStreamOptions, P as ProviderSessionEvent, d as EventListOptions, e as ProviderSessionEventList, f as PlannedAction, D as Diagnostic, A as AgentDefinition, g as AgentWithReadiness, h as AgentSyncRun } from './session-event-C2ED1o1m.js';
-export { i as ActionType, j as ActionTypeSchema, k as AgentDefinitionSchema, l as AgentDriftSeverity, m as AgentDriftSeveritySchema, n as AgentModel, o as AgentModelSchema, p as AgentReadiness, q as AgentReadinessSchema, r as AgentReadinessStatus, s as AgentReadinessStatusSchema, t as AgentRecoveryAction, u as AgentRecoveryActionSchema, v as AgentSkillRef, w as AgentSkillRefSchema, x as AgentSyncResult, y as AgentSyncResultSchema, z as AgentSyncRunSchema, B as AgentSyncStatus, F as AgentSyncStatusSchema, G as AgentWithReadinessSchema, H as CloudAgentSchema, I as CloudEnvironmentSchema, J as CloudVaultSchema, K as CreateSessionRequest, L as CreateSessionRequestSchema, M as CreateSessionResponse, N as CreateSessionResponseSchema, O as DiagnosticSchema, Q as DiagnosticSeverity, S as DiagnosticSeveritySchema, T as DriftKind, U as DriftKindSchema, V as GetSessionRequest, W as GetSessionRequestSchema, X as KNOWN_SESSION_EVENT_TYPES, Y as KnownSessionEventType, Z as ListCloudAgentsResponse, _ as ListCloudAgentsResponseSchema, $ as ListCloudEnvironmentsResponse, a0 as ListCloudEnvironmentsResponseSchema, a1 as ListSessionEventsRequest, a2 as ListSessionEventsRequestSchema, a3 as ListSessionEventsResponse, a4 as ListSessionEventsResponseSchema, a5 as ListSessionsRequest, a6 as ListSessionsRequestSchema, a7 as ListSessionsResponse, a8 as ListSessionsResponseSchema, a9 as PlannedActionSchema, aa as ResourceAddressSchema, ab as ResourceTypeSchema, ac as SendEventRequest, ad as SendEventRequestSchema, ae as SendEventResponse, af as SendEventResponseSchema, ag as Session, ah as SessionAgent, ai as SessionAgentSchema, aj as SessionContentBlock, ak as SessionContentBlockSchema, al as SessionEvent, am as SessionEventSchema, an as SessionEventType, ao as SessionEventTypeName, ap as SessionEventTypeSchema, aq as SessionSchema } from './session-event-C2ED1o1m.js';
+import { R as ResourceAddress, a as ResourceType, C as CloudAgent, b as CloudEnvironment, c as CloudVault, E as EventStreamOptions, P as ProviderSessionEvent, d as EventListOptions, e as ProviderSessionEventList, f as PlannedAction, D as Diagnostic, A as AgentDefinition, g as AgentWithReadiness, h as AgentSyncRun } from './session-event-CObCawiI.js';
+export { i as ActionType, j as ActionTypeSchema, k as AgentDefinitionSchema, l as AgentDriftSeverity, m as AgentDriftSeveritySchema, n as AgentModel, o as AgentModelSchema, p as AgentReadiness, q as AgentReadinessSchema, r as AgentReadinessStatus, s as AgentReadinessStatusSchema, t as AgentRecoveryAction, u as AgentRecoveryActionSchema, v as AgentSkillRef, w as AgentSkillRefSchema, x as AgentSyncResult, y as AgentSyncResultSchema, z as AgentSyncRunSchema, B as AgentSyncStatus, F as AgentSyncStatusSchema, G as AgentWithReadinessSchema, H as CloudAgentSchema, I as CloudEnvironmentSchema, J as CloudVaultSchema, K as CreateSessionRequest, L as CreateSessionRequestSchema, M as CreateSessionResponse, N as CreateSessionResponseSchema, O as DiagnosticSchema, Q as DiagnosticSeverity, S as DiagnosticSeveritySchema, T as DriftKind, U as DriftKindSchema, V as GetSessionRequest, W as GetSessionRequestSchema, X as KNOWN_SESSION_EVENT_TYPES, Y as KnownSessionEventType, Z as ListCloudAgentsResponse, _ as ListCloudAgentsResponseSchema, $ as ListCloudEnvironmentsResponse, a0 as ListCloudEnvironmentsResponseSchema, a1 as ListSessionEventsRequest, a2 as ListSessionEventsRequestSchema, a3 as ListSessionEventsResponse, a4 as ListSessionEventsResponseSchema, a5 as ListSessionsRequest, a6 as ListSessionsRequestSchema, a7 as ListSessionsResponse, a8 as ListSessionsResponseSchema, a9 as PlanReadinessImpact, aa as PlanReadinessImpactSchema, ab as PlannedActionSchema, ac as ResourceAddressSchema, ad as ResourceTypeSchema, ae as SendEventRequest, af as SendEventRequestSchema, ag as SendEventResponse, ah as SendEventResponseSchema, ai as Session, aj as SessionAgent, ak as SessionAgentSchema, al as SessionContentBlock, am as SessionContentBlockSchema, an as SessionEvent, ao as SessionEventSchema, ap as SessionEventType, aq as SessionEventTypeName, ar as SessionEventTypeSchema, as as SessionSchema } from './session-event-CObCawiI.js';
 import { P as ProviderFileInfo } from './file-URqwlxLf.js';
 import 'zod';
 
@@ -13,6 +13,7 @@ interface ProjectConfig {
     providers: Record<string, unknown>;
     defaults?: DefaultsConfig;
     environments?: Record<string, EnvironmentDecl>;
+    tunnels?: Record<string, TunnelDecl>;
     vaults?: Record<string, VaultDecl>;
     memory_stores?: Record<string, MemoryStoreDecl>;
     skills?: Record<string, SkillDecl>;
@@ -22,19 +23,34 @@ interface ProjectConfig {
 }
 interface DefaultsConfig {
     provider?: string;
+    session?: {
+        qoder?: {
+            /** Existing Qoder Forward Identity used only as the CLI/session runtime default. */
+            identity_id?: string;
+        };
+    };
 }
 interface EnvironmentDecl {
     name?: string;
     description?: string;
     provider?: ProviderName;
+    /** Pre-existing provider environment id. When set, OpenCMA treats the environment as an external reference and will not create/update/delete it remotely. */
+    environment_id?: string;
     config: EnvironmentConfig;
     metadata?: Record<string, string>;
 }
 interface EnvironmentConfig {
-    type: "cloud";
+    type: "cloud" | "self_hosted";
     networking?: NetworkingConfig;
     packages?: PackagesConfig;
 }
+interface TunnelDecl {
+    name?: string;
+    description?: string;
+    /** Pre-existing Qoder tunnel id (e.g. tnl_00xxxx). Tunnels are allocated by Qoder BYOC admin and referenced, not created. */
+    tunnel_id: string;
+    metadata?: Record<string, string>;
+}
 interface NetworkingConfig {
     type: "unrestricted" | "limited";
     allow_mcp_servers?: boolean;
@@ -102,6 +118,7 @@ interface AgentDecl {
     model: string | Record<ProviderName, ModelSpec>;
     instructions: string;
     environment?: string;
+    tunnel?: string;
     provider?: ProviderName;
     tools?: AgentToolsDecl;
     mcp_servers?: McpServerDecl[];
@@ -110,6 +127,11 @@ interface AgentDecl {
     memory_stores?: string[];
     multiagent?: MultiagentDecl;
     metadata?: Record<string, string>;
+    /** Provider-specific remote materialization. Omitted means the existing managed Agent resource. */
+    delivery?: Record<ProviderName, AgentDeliveryDecl>;
+}
+interface AgentDeliveryDecl {
+    type: "managed" | "forward";
 }
 type AgentSkillDecl = string | AgentSkillRefDecl;
 interface AgentSkillRefDecl {
@@ -146,6 +168,7 @@ interface DeploymentDecl {
     agent: string;
     agent_version?: number;
     environment?: string;
+    tunnel?: string;
     vaults?: string[];
     memory_stores?: string[];
     resources?: DeploymentResourceDecl[];
@@ -210,21 +233,37 @@ interface SessionFileResource {
     file_id: string;
     mount_path: string;
 }
-interface SessionBindings {
+interface CommonSessionBindings {
+    /** Uploaded files to mount in the session sandbox. */
+    files?: SessionFileResource[];
+    title?: string;
+    metadata?: Record<string, string>;
+}
+interface ManagedSessionBindings extends CommonSessionBindings {
+    /** Omitted for backward compatibility; omitted always means managed. */
+    delivery?: "managed";
     agent_id: string;
     agent_version?: number;
     /** Cloud sandbox id. Every provider runs sessions inside an environment. */
     environment_id: string;
+    /** Qoder BYOC tunnel id. Required to reach internal MCP servers from the sandbox. */
+    tunnel_id?: string;
     vault_ids: string[];
     memory_store_ids: string[];
-    files?: SessionFileResource[];
-    title?: string;
-    metadata?: Record<string, string>;
 }
+interface ForwardSessionBindings extends CommonSessionBindings {
+    delivery: "forward";
+    /** Qoder Forward Template selected from the applied Agent materialization. */
+    template_id: string;
+    /** Existing business Identity supplied by the session caller; omitted uses the provider's default Identity. */
+    identity_id?: string;
+}
+type SessionBindings = ManagedSessionBindings | ForwardSessionBindings;
 interface ProviderSessionInfo {
     id: string;
     agent_id: string;
     environment_id: string;
+    tunnel_id?: string;
     status: string;
     title?: string;
     vault_ids: string[];
@@ -263,6 +302,11 @@ interface ProviderSkillInfo {
 interface ResourceState {
     address: ResourceAddress;
     remote_id: string | null;
+    /**
+     * This resource is owned by the provider or another system and is only
+     * referenced by this project. It must never be deleted remotely.
+     */
+    externally_managed?: boolean;
     version?: number;
     /**
      * Backward-compatible alias for desired_hash. Kept while older state files
@@ -271,10 +315,17 @@ interface ResourceState {
     content_hash: string;
     desired_hash?: string;
     desired_comparable_hash?: string;
+    desired_readiness_baseline?: ResourceReadinessBaseline;
     remote_hash?: string;
     remote_snapshot?: unknown;
+    drift_paths?: string[];
     drift_status?: "in_sync" | "drifted" | "missing" | "unchecked";
 }
+interface ResourceReadinessBaseline {
+    operational_hash: string;
+    description_hash: string;
+    metadata_hash: string;
+}
 interface StateFile {
     resources: ResourceState[];
 }
@@ -319,10 +370,18 @@ interface ResolvedAgentRefs {
     }>;
     multiagent_agent_ids?: string[];
 }
+interface ResolvedTemplateRefs extends ResolvedAgentRefs {
+    environment_id: string;
+    /** Qoder BYOC private-network route used by Forward Templates. */
+    tunnel_id?: string;
+    vault_ids: string[];
+}
 interface ResolvedDeploymentRefs {
     agent_id: string;
     agent_version?: number;
     environment_id: string;
+    /** Qoder BYOC tunnel id. Passed through only when the deployment targets Qoder BYOC. */
+    tunnel_id?: string;
     vault_ids: string[];
     memory_store_ids: Record<string, string>;
 }
@@ -401,6 +460,10 @@ interface ProviderAdapter {
     createAgent(name: string, decl: AgentDecl, refs: ResolvedAgentRefs): Promise<RemoteResource>;
     updateAgent(id: string, name: string, decl: AgentDecl, refs: ResolvedAgentRefs): Promise<RemoteResource>;
     deleteAgent(id: string): Promise<void>;
+    createTemplate?(name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
+    updateTemplate?(id: string, name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
+    /** Remove the template from desired state. Qoder implements this as a soft archive. */
+    archiveTemplate?(id: string): Promise<void>;
     createMemoryStore?(name: string, decl: MemoryStoreDecl): Promise<RemoteResource>;
     deleteMemoryStore?(id: string): Promise<void>;
     createDeployment(name: string, decl: DeploymentDecl, refs: ResolvedDeploymentRefs, basePath: string): Promise<RemoteResource>;
@@ -770,7 +833,7 @@ declare function runDeploymentForContext(ctx: ProjectRuntimeContext, name: strin
 declare function getDeploymentRuntimeProviderForContext(ctx: ProjectRuntimeContext, name: string, overrideProvider?: string): string;
 
 type DestroyResourceStatus = "success" | "failed" | "blocked" | "skipped";
-type DestroyResourceResultReason = "destroyed" | "already_gone" | "cascade_required" | "provider_missing" | "failed" | "skipped";
+type DestroyResourceResultReason = "destroyed" | "reference_removed" | "already_gone" | "cascade_required" | "provider_missing" | "failed" | "skipped";
 interface DestroyResourceResult {
     resource: ResourceState;
     status: DestroyResourceStatus;
@@ -852,6 +915,7 @@ interface AgentBuildInput {
     model?: AgentDecl["model"];
     instructions?: string;
     environment?: string;
+    vault?: string;
     provider?: string;
     builtinTools?: string[];
     skills?: AgentSkillBuildInput[];
@@ -936,6 +1000,8 @@ declare function listAgentsWithReadiness(ctx: ProjectRuntimeContext, options?: {
 declare function syncAgentResourcesWithStateBackend(input: BackendRuntimeInput, agentId: string, options?: AgentResourceSyncOptions): Promise<AgentSyncRun>;
 
 interface SessionCreateOptions {
+    /** Explicit Qoder Forward Identity id. Overrides defaults.session.qoder.identity_id. */
+    identityId?: string;
     environment?: string;
     /**
      * Explicit remote environment id. When set, it is bound directly (bypassing the
@@ -944,6 +1010,10 @@ interface SessionCreateOptions {
      * Takes precedence over `environment` / the agent's declared environment.
      */
     environmentId?: string;
+    /** Tunnel name referencing `tunnels.<name>` in config. */
+    tunnel?: string;
+    /** Explicit remote tunnel id. Takes precedence over `tunnel` / the agent's declared tunnel. */
+    tunnelId?: string;
     vault?: string;
     /**
      * Explicit remote vault ids. When set, they are bound directly (bypassing the