@openagentpack/sdk 0.7.1 → 0.7.3

package/dist/{chunk-HIK5DY4I.js → chunk-DFRNXUT3.js}

@@ -14,7 +14,7 @@ import {
   resolveFetch,
   resolveTargetProviders,
   skillNameFromFiles
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-IRA4LOCJ.js";
 
 // src/internal/core/project-runtime.ts
 function createProjectRuntime(input) {
@@ -403,11 +403,11 @@ function structurallyEqual(left, right) {
 function supportsFullDrift(adapter, type) {
   return adapter.getDriftSupport?.(type) === "full" && typeof adapter.readComparableResource === "function";
 }
-async function readComparableIfSupported(adapter, type, id, name) {
+async function readComparableIfSupported(adapter, type, id, name, decl) {
   if (!supportsFullDrift(adapter, type)) return null;
   if (typeof adapter.readComparableResource !== "function") return null;
   try {
-    return await adapter.readComparableResource(type, id, name);
+    return await adapter.readComparableResource(type, id, name, decl);
   } catch {
     return null;
   }
@@ -1232,7 +1232,13 @@ async function executeActionInner(action, provider, ctx) {
   const comparableHash = computeComparableDesiredHash(address, ctx.config, provider);
   let remoteHash = comparableHash;
   let remoteSnapshot;
-  const remote = await readComparableIfSupported(provider, type, result.id, name);
+  const remote = await readComparableIfSupported(
+    provider,
+    type,
+    result.id,
+    name,
+    getResourceDeclaration(address, ctx.config) ?? void 0
+  );
   if (remote) {
     remoteHash = contentHash(remote.comparable);
     remoteSnapshot = remote.snapshot ?? remote.comparable;
@@ -1845,7 +1851,13 @@ async function refreshState(state, providers, options = {}) {
     try {
       const support = provider.getDriftSupport?.(res.address.type) ?? "existence";
       if (supportsFullDrift(provider, res.address.type) && provider.normalizeDesiredResource) {
-        const remote2 = await provider.readComparableResource?.(res.address.type, res.remote_id, res.address.name);
+        const decl = options.config ? getResourceDeclaration(res.address, options.config) : null;
+        const remote2 = await provider.readComparableResource?.(
+          res.address.type,
+          res.remote_id,
+          res.address.name,
+          decl ?? void 0
+        );
         if (!remote2) {
           if (!options.quiet) {
             emitRuntimeFeedback(options.onFeedback, {
@@ -1861,7 +1873,6 @@ async function refreshState(state, providers, options = {}) {
           continue;
         }
         const remoteHash = contentHash(remote2.comparable);
-        const decl = options.config ? getResourceDeclaration(res.address, options.config) : null;
         const desiredComparable = decl ? provider.normalizeDesiredResource(res.address.type, res.address.name, decl) : null;
         const desiredComparableHash = desiredComparable === null ? void 0 : contentHash(desiredComparable);
         const baselineHash = res.desired_comparable_hash ?? desiredComparableHash ?? remoteHash;
@@ -2011,7 +2022,13 @@ async function importResource(ctx, address, remoteId, options = {}) {
     throw new UserError(`Planned ${address.type}.${address.name} is missing a content hash.`);
   }
   const provider = ctx.providers.get(address.provider);
-  const remote = provider ? await readComparableIfSupported(provider, address.type, remoteId, address.name) : null;
+  const remote = provider ? await readComparableIfSupported(
+    provider,
+    address.type,
+    remoteId,
+    address.name,
+    getResourceDeclaration(address, ctx.config) ?? void 0
+  ) : null;
   const remoteHash = remote ? contentHash(remote.comparable) : void 0;
   const resource = {
     address,

package/dist/{chunk-ZBJDMUJT.js → chunk-IRA4LOCJ.js}

@@ -1361,6 +1361,13 @@ function injectMetadata(userMetadata, projectName, resourceName) {
   };
   return { ...injected, ...userMetadata };
 }
+function injectManagedResourceMetadata(userMetadata, projectName, resourceName) {
+  return {
+    ...userMetadata,
+    "agents.project": projectName,
+    "agents.resource": resourceName
+  };
+}
 function slug(value, fallback) {
   const out = (value ?? "").trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
   return out || fallback;
@@ -2574,6 +2581,7 @@ function normalizeEnvironmentPackages(value) {
   return Object.keys(packages).length > 0 ? packages : void 0;
 }
 function mapEnvironment2(name, decl, projectName) {
+  const displayName = decl.name ?? name;
   const envType = decl.config.type ?? "cloud";
   const config = { type: envType };
   if (decl.config.networking) config.networking = decl.config.networking;
@@ -2582,10 +2590,10 @@ function mapEnvironment2(name, decl, projectName) {
   if (packages) config.packages = packages;
   if (decl.config.setup_script !== void 0) config.setup_script = decl.config.setup_script;
   return {
-    name,
+    name: displayName,
     description: decl.description ?? "",
     config,
-    metadata: injectMetadata(decl.metadata, projectName, name)
+    metadata: injectManagedResourceMetadata(decl.metadata, projectName, displayName)
   };
 }
 function mapForwardEnvironment(name, decl, projectName) {
@@ -2836,15 +2844,16 @@ function mapAgent2(name, decl, refs, version, projectName) {
     if (!qoderModel) throw new UserError(`No Qoder model specified for agent '${name}'`);
     model = typeof qoderModel === "string" ? qoderModel : qoderModel.id;
   }
+  const displayName = decl.name ?? name;
   const body = {
-    name: decl.name ?? name,
+    name: displayName,
     model,
     system: decl.instructions
   };
   if (version !== void 0) body.version = version;
   if (decl.description) body.description = decl.description;
   if (projectName) {
-    body.metadata = injectMetadata(decl.metadata, projectName, name);
+    body.metadata = injectManagedResourceMetadata(decl.metadata, projectName, displayName);
   } else if (decl.metadata) {
     body.metadata = decl.metadata;
   }
@@ -2885,12 +2894,10 @@ function mapAgent2(name, decl, refs, version, projectName) {
       }
     }
   }
-  if (refs.skill_ids.length) {
-    body.skills = refs.skill_ids.map((s) => ({
-      type: s.type === "official" ? "qoder" : s.type,
-      skill_id: s.skill_id
-    }));
-  }
+  body.skills = refs.skill_ids.map((s) => ({
+    type: s.type === "official" ? "qoder" : s.type,
+    skill_id: s.skill_id
+  }));
   return body;
 }
 function mapForwardTemplate(name, decl, refs, projectName) {
@@ -3230,7 +3237,7 @@ var QoderAdapter = class _QoderAdapter {
     if (type === "deployment") return "unsupported";
     return _QoderAdapter.ENDPOINT_MAP[type] ? "existence" : "unsupported";
   }
-  async readComparableResource(type, id, name) {
+  async readComparableResource(type, id, name, decl) {
     if (type !== "agent" && type !== "environment" && type !== "template" && type !== "identity" && type !== "channel")
       return null;
     if (type === "identity" || type === "channel") {
@@ -3242,15 +3249,22 @@ var QoderAdapter = class _QoderAdapter {
       const comparable2 = this.normalizeRemote(type, raw2);
       return { id: remote.id, type, comparable: comparable2, snapshot: comparable2 };
     }
-    const isTemplate = type === "template";
-    const endpoint = type === "agent" ? "/agents" : type === "environment" ? "/environments" : "/templates";
-    const raw = await locateRemote(
-      isTemplate ? this.forwardClient : this.client,
-      endpoint,
-      name,
-      id,
-      isTemplate ? (item) => item.status !== "archived" : notArchived
-    );
+    let raw;
+    if ((type === "agent" || type === "environment") && decl !== void 0 && this.projectName) {
+      const declaredName = decl.name;
+      const displayName = typeof declaredName === "string" ? declaredName : name;
+      raw = await this.readManagedResourceByIdentity(type, id, displayName);
+    } else {
+      const isTemplate = type === "template";
+      const endpoint = type === "agent" ? "/agents" : type === "environment" ? "/environments" : "/templates";
+      raw = await locateRemote(
+        isTemplate ? this.forwardClient : this.client,
+        endpoint,
+        name,
+        id,
+        isTemplate ? (item) => item.status !== "archived" : notArchived
+      );
+    }
     if (!raw) return null;
     const comparable = this.normalizeRemote(type, raw);
     return {
@@ -3261,6 +3275,38 @@ var QoderAdapter = class _QoderAdapter {
       snapshot: comparable
     };
   }
+  async readManagedResourceByIdentity(type, id, displayName) {
+    const endpoint = type === "agent" ? "/agents" : "/environments";
+    if (id) {
+      try {
+        const raw = await this.client.get(`${endpoint}/${id}`);
+        return this.matchesManagedResourceIdentity(type, raw, displayName) ? raw : null;
+      } catch (error) {
+        if (ApiError.isNotFound(error)) return null;
+        throw error;
+      }
+    }
+    const matches = (await this.client.getAllPaged(endpoint)).filter(
+      (raw) => this.matchesManagedResourceIdentity(type, raw, displayName)
+    );
+    if (matches.length !== 1) return null;
+    const matchedId = matches[0]?.id;
+    if (typeof matchedId !== "string") return null;
+    try {
+      const raw = await this.client.get(`${endpoint}/${matchedId}`);
+      return this.matchesManagedResourceIdentity(type, raw, displayName) ? raw : null;
+    } catch (error) {
+      if (ApiError.isNotFound(error)) return null;
+      throw error;
+    }
+  }
+  matchesManagedResourceIdentity(type, raw, displayName) {
+    if (!notArchived(raw) || raw.name !== displayName) return false;
+    if (typeof raw.type === "string" && raw.type !== type) return false;
+    const metadata = raw.metadata;
+    if (!metadata || typeof metadata !== "object") return false;
+    return metadata["agents.project"] === this.projectName && metadata["agents.resource"] === displayName;
+  }
   normalizeDesiredResource(type, name, decl) {
     if (type === "environment") {
       return this.normalizeRemote(
@@ -3342,7 +3388,7 @@ var QoderAdapter = class _QoderAdapter {
     }
     return compactDeep({
       name: raw.name,
-      description: raw.description,
+      description: raw.description === "" ? void 0 : raw.description,
       model: normalizeModel(raw.model),
       instructions: raw.system,
       tools: normalizeQoderTools(raw.tools),
@@ -4356,18 +4402,16 @@ function mapAgent3(name, decl, refs, version, projectName, skillVersions) {
       });
     }
   }
-  if (refs.skill_ids.length) {
-    body.skills = refs.skill_ids.map((s) => ({
-      // Bailian's SkillType enum is "customer" | "official"; map the
-      // resolver's generic "custom" sentinel to "customer".
-      type: s.type === "custom" ? "customer" : s.type,
-      skill_id: s.skill_id,
-      // Bailian composes `{skill_id}@{version}` internally and rejects
-      // entries without a version. Prefer explicit external references, then
-      // the latest active remote version, then the common initial version.
-      version: s.version ?? skillVersions?.[s.skill_id] ?? "1.0"
-    }));
-  }
+  body.skills = refs.skill_ids.map((s) => ({
+    // Bailian's SkillType enum is "customer" | "official"; map the
+    // resolver's generic "custom" sentinel to "customer".
+    type: s.type === "custom" ? "customer" : s.type,
+    skill_id: s.skill_id,
+    // Bailian composes `{skill_id}@{version}` internally and rejects
+    // entries without a version. Prefer explicit external references, then
+    // the latest active remote version, then the common initial version.
+    version: s.version ?? skillVersions?.[s.skill_id] ?? "1.0"
+  }));
   return body;
 }
 function mapSession3(bindings) {

package/dist/{chunk-56BB46YT.js → chunk-XQMLTTGI.js}

@@ -1,7 +1,7 @@
 import {
   UserError,
   inspectProjectSource
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-IRA4LOCJ.js";
 
 // src/internal/project-versions/directory.ts
 import { createHash, randomUUID } from "crypto";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { U as UserError } from './errors-BcVE1wZB.js';
-import { P as ProjectConfig, S as SkillFile, R as ResolvedProjectConfig, a as ProjectRuntimeContext, D as DeploymentContext, b as DeploymentRunResult$1, c as DeploymentInfo$1, d as DeploymentListFilter, e as DeploymentListResult, f as ResourceState, g as ProviderSessionInfo, M as ManagedAgentProviderCapabilities, h as DeploymentRunInfo, i as ProviderSkillInfo, j as SkillDownloadInfo, k as SkillVersionInfo, A as AgentVersionListOptions, l as AgentPage, m as AgentListOptions, n as DeploymentRunPage, E as EnvironmentListOptions, o as EnvironmentPage, F as FileListOptions, p as FilePage, q as SkillVersionListOptions, r as SkillVersionPage, s as SkillListOptions, t as SkillPage, V as VaultListOptions, u as VaultPage, v as SessionEventInput, w as SessionEventSendResult, x as SessionUpdateInput, B as BackendRuntimeInput, y as RuntimeFeedbackSink, z as ModelInfo, C as ProviderAdapter, G as MemoryStoreInfo, H as BatchCreateMemoryInput, I as BatchCreateMemoryResult, J as CreateMemoryInput, K as MemoryInfo, L as CreateMemoryStoreInput, N as MemoryProviderCapabilities, O as MemoryVersionInfo, Q as MemoryListOptions, T as MemoryPage, U as MemoryListItem, W as MemoryStoreListOptions, X as MemoryVersionListOptions, Y as UpdateMemoryInput, Z as UpdateMemoryStoreInput, _ as AgentDecl, $ as SkillDecl, a0 as ResourcePlanResult, a1 as ResourceSyncMode, a2 as DestructivePolicy, a3 as EnvironmentDecl, a4 as RemoteResource, a5 as VaultDecl, a6 as SessionResourceDecl, a7 as SessionFilter, a8 as SessionBindings, a9 as SessionGithubRepositoryResource, aa as StateBackend, ab as StateScope, ac as IStateManager } from './resource-runtime-DZDY45_Q.js';
-export { ad as CredentialDecl, ae as CredentialInjectionLocation, af as CredentialNetworking, ag as CursorListOptions, ah as CursorPage, ai as DeploymentDecl, aj as LoadedProjectConfig, ak as ManagedAgentOperationAuth, al as ManagedAgentOperationCapability, am as MemoryPrefixInfo, an as ResourceActionResult, ao as ResourceExecutionResult, ap as ResourcePlanScope, aq as ResourceRefreshResult, ar as ResourceRuntimeOptions, as as ResourceSyncRun, at as RuntimeFeedbackEvent, au as SessionListResult, av as StateManager, aw as VaultCredentialInfo, ax as createProjectRuntime, ay as decideDestructive, az as executePlannedProject, aA as importResource, aB as planProjectContext, aC as planProjectWithStateBackend, aD as readProjectRuntime, aE as resolveProjectConfig, aF as resolveProjectConfigFromObject, aG as syncProjectResourcesWithStateBackend, aH as writeProjectRuntime } from './resource-runtime-DZDY45_Q.js';
+import { P as ProjectConfig, S as SkillFile, R as ResolvedProjectConfig, a as ProjectRuntimeContext, D as DeploymentContext, b as DeploymentRunResult$1, c as DeploymentInfo$1, d as DeploymentListFilter, e as DeploymentListResult, f as ResourceState, g as ProviderSessionInfo, M as ManagedAgentProviderCapabilities, h as DeploymentRunInfo, i as ProviderSkillInfo, j as SkillDownloadInfo, k as SkillVersionInfo, A as AgentVersionListOptions, l as AgentPage, m as AgentListOptions, n as DeploymentRunPage, E as EnvironmentListOptions, o as EnvironmentPage, F as FileListOptions, p as FilePage, q as SkillVersionListOptions, r as SkillVersionPage, s as SkillListOptions, t as SkillPage, V as VaultListOptions, u as VaultPage, v as SessionEventInput, w as SessionEventSendResult, x as SessionUpdateInput, B as BackendRuntimeInput, y as RuntimeFeedbackSink, z as ModelInfo, C as ProviderAdapter, G as MemoryStoreInfo, H as BatchCreateMemoryInput, I as BatchCreateMemoryResult, J as CreateMemoryInput, K as MemoryInfo, L as CreateMemoryStoreInput, N as MemoryProviderCapabilities, O as MemoryVersionInfo, Q as MemoryListOptions, T as MemoryPage, U as MemoryListItem, W as MemoryStoreListOptions, X as MemoryVersionListOptions, Y as UpdateMemoryInput, Z as UpdateMemoryStoreInput, _ as AgentDecl, $ as SkillDecl, a0 as ResourcePlanResult, a1 as ResourceSyncMode, a2 as DestructivePolicy, a3 as EnvironmentDecl, a4 as RemoteResource, a5 as VaultDecl, a6 as SessionResourceDecl, a7 as SessionFilter, a8 as SessionBindings, a9 as SessionGithubRepositoryResource, aa as StateBackend, ab as StateScope, ac as IStateManager } from './resource-runtime-DZsBWDjg.js';
+export { ad as CredentialDecl, ae as CredentialInjectionLocation, af as CredentialNetworking, ag as CursorListOptions, ah as CursorPage, ai as DeploymentDecl, aj as LoadedProjectConfig, ak as ManagedAgentOperationAuth, al as ManagedAgentOperationCapability, am as MemoryPrefixInfo, an as ResourceActionResult, ao as ResourceExecutionResult, ap as ResourcePlanScope, aq as ResourceRefreshResult, ar as ResourceRuntimeOptions, as as ResourceSyncRun, at as RuntimeFeedbackEvent, au as SessionListResult, av as StateManager, aw as VaultCredentialInfo, ax as createProjectRuntime, ay as decideDestructive, az as executePlannedProject, aA as importResource, aB as planProjectContext, aC as planProjectWithStateBackend, aD as readProjectRuntime, aE as resolveProjectConfig, aF as resolveProjectConfigFromObject, aG as syncProjectResourcesWithStateBackend, aH as writeProjectRuntime } from './resource-runtime-DZsBWDjg.js';
 import { D as Diagnostic, R as ResourceType, P as PlannedAction, A as AgentDefinition, a as AgentReadiness, b as AgentWithReadiness, C as CloudAgent, c as CloudEnvironment, d as CloudVault, e as AgentSyncRun, f as ResourceAddress } from './dto-BT1Q1Ii6.js';
 export { g as ActionType, h as ActionTypeSchema, i as AgentDefinitionSchema, j as AgentDriftSeverity, k as AgentDriftSeveritySchema, l as AgentModel, m as AgentModelSchema, n as AgentReadinessSchema, o as AgentReadinessStatus, p as AgentReadinessStatusSchema, q as AgentRecoveryAction, r as AgentRecoveryActionSchema, s as AgentSkillRef, t as AgentSkillRefSchema, u as AgentSyncReason, v as AgentSyncReasonSchema, w as AgentSyncResult, x as AgentSyncResultSchema, y as AgentSyncRunSchema, z as AgentSyncStatus, B as AgentSyncStatusSchema, E as AgentWithReadinessSchema, F as CloudAgentSchema, G as CloudEnvironmentSchema, H as CloudVaultSchema, I as CreateSessionRequest, J as CreateSessionRequestSchema, K as CreateSessionResponse, L as CreateSessionResponseSchema, M as DiagnosticSchema, N as DiagnosticSeverity, O as DiagnosticSeveritySchema, Q as DriftKind, S as DriftKindSchema, T as GetSessionRequest, U as GetSessionRequestSchema, V as KNOWN_SESSION_EVENT_TYPES, W as KnownSessionEventType, X as ListCloudAgentsResponse, Y as ListCloudAgentsResponseSchema, Z as ListCloudEnvironmentsResponse, _ as ListCloudEnvironmentsResponseSchema, $ as ListSessionEventsRequest, a0 as ListSessionEventsRequestSchema, a1 as ListSessionEventsResponse, a2 as ListSessionEventsResponseSchema, a3 as ListSessionsRequest, a4 as ListSessionsRequestSchema, a5 as ListSessionsResponse, a6 as ListSessionsResponseSchema, a7 as PlanReadinessImpact, a8 as PlanReadinessImpactSchema, 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 './dto-BT1Q1Ii6.js';
 import { P as ProviderFileInfo } from './file-Cj5-Vx27.js';

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   selectDestructive,
   syncProjectResourcesWithStateBackend,
   writeProjectRuntime
-} from "./chunk-HIK5DY4I.js";
+} from "./chunk-DFRNXUT3.js";
 import {
   ApiError,
   ConflictError,
@@ -49,7 +49,7 @@ import {
   rewriteFileMentions,
   setDefaultFetch,
   validateProjectConfig
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-IRA4LOCJ.js";
 import "./chunk-6PDVAFLK.js";
 import {
   defaultFileUploadPurpose,

package/dist/project-versions.js

@@ -13,8 +13,8 @@ import {
   readProjectVersionSource,
   releasePreparedProjectVersion,
   restoreProjectVersion
-} from "./chunk-56BB46YT.js";
-import "./chunk-ZBJDMUJT.js";
+} from "./chunk-XQMLTTGI.js";
+import "./chunk-IRA4LOCJ.js";
 import "./chunk-6PDVAFLK.js";
 import "./chunk-CHGDM6TX.js";
 export {

package/dist/project-workspace.d.ts

@@ -1,4 +1,4 @@
-import { aj as LoadedProjectConfig, a0 as ResourcePlanResult, as as ResourceSyncRun, y as RuntimeFeedbackSink } from './resource-runtime-DZDY45_Q.js';
+import { aj as LoadedProjectConfig, a0 as ResourcePlanResult, as as ResourceSyncRun, y as RuntimeFeedbackSink } from './resource-runtime-DZsBWDjg.js';
 import { U as UserError } from './errors-BcVE1wZB.js';
 import { D as Diagnostic, P as PlannedAction } from './dto-BT1Q1Ii6.js';
 import { e as DirectoryProjectVersionService } from './directory-nY2Slsfi.js';

package/dist/project-workspace.js

@@ -4,17 +4,17 @@ import {
   planProjectContext,
   planProjectWithStateBackend,
   writeProjectRuntime
-} from "./chunk-HIK5DY4I.js";
+} from "./chunk-DFRNXUT3.js";
 import {
   createDirectoryProjectVersionService
-} from "./chunk-56BB46YT.js";
+} from "./chunk-XQMLTTGI.js";
 import {
   UserError,
   inspectProjectSource,
   resolveProjectConfig,
   resolveProjectConfigFromObject,
   validateProjectConfig
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-IRA4LOCJ.js";
 import "./chunk-6PDVAFLK.js";
 import "./chunk-CHGDM6TX.js";
 

package/dist/{resource-runtime-DZDY45_Q.d.ts → resource-runtime-DZsBWDjg.d.ts}

@@ -809,7 +809,7 @@ interface ProviderAdapter {
     listVaultResources?(options?: VaultListOptions): Promise<VaultPage>;
     getRemoteVault?(id: string): Promise<CloudVault>;
     getDriftSupport?(type: ResourceType): DriftSupport;
-    readComparableResource?(type: ResourceType, id: string | null, name: string): Promise<ComparableRemoteResource | null>;
+    readComparableResource?(type: ResourceType, id: string | null, name: string, decl?: unknown): Promise<ComparableRemoteResource | null>;
     normalizeDesiredResource?(type: ResourceType, name: string, decl: unknown): unknown | null;
     /**
      * Reverse-map remote resources of a given type into `agents.yaml` declarations

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentpack/sdk",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "OpenAgentPack SDK (Node-compatible runtime)",
   "license": "Apache-2.0",
   "keywords": [