@openagentpack/sdk 0.7.0 → 0.7.2

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

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

package/dist/{chunk-ZBJDMUJT.js → chunk-HLZOSZ7B.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;
   }
@@ -3230,7 +3239,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 +3251,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 +3277,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 +3390,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),

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

@@ -14,7 +14,7 @@ import {
   resolveFetch,
   resolveTargetProviders,
   skillNameFromFiles
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-HLZOSZ7B.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/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-LJQMLMAT.js";
 import {
   ApiError,
   ConflictError,
@@ -49,7 +49,7 @@ import {
   rewriteFileMentions,
   setDefaultFetch,
   validateProjectConfig
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-HLZOSZ7B.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-7L73W3DL.js";
+import "./chunk-HLZOSZ7B.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-LJQMLMAT.js";
 import {
   createDirectoryProjectVersionService
-} from "./chunk-56BB46YT.js";
+} from "./chunk-7L73W3DL.js";
 import {
   UserError,
   inspectProjectSource,
   resolveProjectConfig,
   resolveProjectConfigFromObject,
   validateProjectConfig
-} from "./chunk-ZBJDMUJT.js";
+} from "./chunk-HLZOSZ7B.js";
 import "./chunk-6PDVAFLK.js";
 import "./chunk-CHGDM6TX.js";
 
@@ -77,11 +77,11 @@ Use this Skill when the user asks to summarize text.
   the directory is the upload source. Do not put secrets in these files.
   \`SKILL.md\` \u662F Skill \u6307\u4EE4\uFF0C\u9700\u8981\u7684\u811A\u672C\u548C\u7D20\u6750\u4E5F\u653E\u5728\u6B64\u76EE\u5F55\uFF1B\u6574\u4E2A\u76EE\u5F55\u4F5C\u4E3A\u4E0A\u4F20\u6E90\uFF0C\u8BF7\u52FF\u653E\u5165\u5BC6\u94A5\u3002
 - This example is ignored by Build/Publish. Copy it from \`skills/_examples/example-skill/\`
-  to \`skills/example-skill/\`, then add \`"skills": ["example-skill"]\` to \`agent.json\`.
-  \u6B64\u793A\u4F8B\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\u3002\u590D\u5236\u5230 \`skills/example-skill/\` \u540E\uFF0C\u518D\u5728 Agent \u4E2D\u6DFB\u52A0\u4E0A\u8FF0\u5F15\u7528\u3002
+  to \`skills/example-skill/\`, then Build adds \`"example-skill"\` to \`agent.json.skills\` automatically.
+  \u6B64\u793A\u4F8B\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\u3002\u590D\u5236\u5230 \`skills/example-skill/\` \u540E\uFF0CBuild \u4F1A\u81EA\u52A8\u8865\u9F50 Agent \u5F15\u7528\u3002
 - To add another Skill, copy this directory, change the directory name and \`skill.json.id\`,
-  then add its ID to \`agent.json.skills\`. A new directory with only \`SKILL.md\` is also discovered by Build.
-  \u65B0\u589E Skill \u65F6\u590D\u5236\u6B64\u76EE\u5F55\u3001\u4FEE\u6539\u76EE\u5F55\u540D\u548C ID\uFF0C\u518D\u5728 Agent \u4E2D\u5F15\u7528\uFF1B\u53EA\u653E \`SKILL.md\` \u7684\u65B0\u76EE\u5F55\u4E5F\u80FD\u7531 Build \u81EA\u52A8\u5173\u8054\u3002
+  then run Build to add its ID to \`agent.json.skills\`. A new directory with only \`SKILL.md\` is also discovered by Build.
+  \u65B0\u589E Skill \u65F6\u590D\u5236\u6B64\u76EE\u5F55\u3001\u4FEE\u6539\u76EE\u5F55\u540D\u548C ID\uFF0C\u518D\u8FD0\u884C Build \u81EA\u52A8\u5173\u8054\uFF1B\u53EA\u653E \`SKILL.md\` \u7684\u65B0\u76EE\u5F55\u4E5F\u80FD\u7531 Build \u81EA\u52A8\u5173\u8054\u3002
 - Delete this ignored example directory if not needed. For an enabled Skill, also remove its Agent reference.
   \u4E0D\u9700\u8981\u65F6\u53EF\u76F4\u63A5\u5220\u9664\u672C\u793A\u4F8B\u76EE\u5F55\uFF1B\u82E5\u5DF2\u7ECF\u542F\u7528\uFF0C\u8FD8\u9700\u5220\u9664 Agent \u5F15\u7528\u3002
 `,
@@ -106,8 +106,8 @@ at \`/mnt/example.md\` in agent.json.
 - \`source\` is relative to this resource directory. Keep \`id\` equal to the directory name.
   \`source\` \u76F8\u5BF9\u6B64\u8D44\u6E90\u76EE\u5F55\u89E3\u6790\uFF0C\`id\` \u5E94\u4E0E\u76EE\u5F55\u540D\u4E00\u81F4\u3002
 - Build/Publish ignore this example. Copy \`files/_examples/example-file/\` to \`files/example-file/\`
-  to enable its declaration; add \`"files": [{"file": "example-file", "mount_path": "/mnt/example.md"}]\` to \`agent.json\`.
-  \u6B64\u793A\u4F8B\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\u3002\u590D\u5236\u5230 \`files/example-file/\` \u540E\u542F\u7528\u58F0\u660E\uFF0C\u518D\u6DFB\u52A0\u4E0A\u8FF0\u6302\u8F7D\u5F15\u7528\uFF1B\u6302\u8F7D\u8DEF\u5F84\u5FC5\u987B\u5728 \`/mnt/\` \u4E0B\u3002
+  to enable its declaration; Build adds \`{"file": "example-file", "mount_path": "/mnt/example.md"}\` to \`agent.json.files\`.
+  \u6B64\u793A\u4F8B\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\u3002\u590D\u5236\u5230 \`files/example-file/\` \u540E\uFF0CBuild \u81EA\u52A8\u6DFB\u52A0\u4E0A\u8FF0\u6302\u8F7D\u5F15\u7528\uFF1B\u5DF2\u6709\u81EA\u5B9A\u4E49\u6302\u8F7D\u8DEF\u5F84\u4F1A\u4FDD\u7559\uFF0C\u6302\u8F7D\u8DEF\u5F84\u5FC5\u987B\u5728 \`/mnt/\` \u4E0B\u3002
 - Uploading a File does not permanently attach it to the remote Agent. These declarations
   supply default mounts for new Sessions; existing Sessions are unchanged.
   \u4E0A\u4F20 File \u4E0D\u7B49\u4E8E\u6C38\u4E45\u7ED1\u5B9A\u5230\u8FDC\u7AEF Agent\uFF1B\u8FD9\u91CC\u58F0\u660E\u7684\u662F\u65B0 Session \u7684\u9ED8\u8BA4\u6302\u8F7D\uFF0C\u4E0D\u4FEE\u6539\u5DF2\u6709 Session\u3002
@@ -133,9 +133,10 @@ at \`/mnt/example.md\` in agent.json.
 
 Build/Publish ignore this directory; no example secret is required to open Workbench.
 Copy \`vaults/_examples/example-vault/\` to \`vaults/example-vault/\` to enable the declaration,
-then add \`"vault": "example-vault"\` to \`agent.json\` and supply the secret.
+then supply the secret and run Build. If \`agent.json.vault\` is unset, Build selects the sole local Vault automatically.
+With multiple local Vaults, set \`"vault": "example-vault"\` explicitly; Build never overwrites an existing selection.
 \u6B64\u793A\u4F8B\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\uFF0C\u4E0D\u9700\u8981\u914D\u7F6E\u5BC6\u94A5\u5373\u53EF\u6253\u5F00 Workbench\u3002
-\u542F\u7528\u65F6\uFF0C\u590D\u5236\u5230 \`vaults/example-vault/\`\uFF0C\u5728 Agent \u4E2D\u6DFB\u52A0\u4E0A\u8FF0\u5F15\u7528\uFF0C\u5E76\u914D\u7F6E\u5BC6\u94A5\u3002
+\u542F\u7528\u65F6\uFF0C\u590D\u5236\u5230 \`vaults/example-vault/\`\uFF0C\u914D\u7F6E\u5BC6\u94A5\u540E\u8FD0\u884C Build\u3002\u672A\u6307\u5B9A Vault \u65F6\u81EA\u52A8\u5173\u8054\u552F\u4E00\u5019\u9009\uFF1B\u591A\u4E2A\u5019\u9009\u9700\u663E\u5F0F\u9009\u62E9\uFF0C\u5DF2\u6709\u5F15\u7528\u4E0D\u8986\u76D6\u3002
 
 The example \`vault.json\` contains:
 \u793A\u4F8B \`vault.json\` \u7684\u5B8C\u6574\u914D\u7F6E\u5982\u4E0B\uFF1A
@@ -184,8 +185,9 @@ ${JSON.stringify(
     [`${agentRoot}/environments/${RESOURCE_EXAMPLES_DIRECTORY}/example-env/README.md`]: `# Environment example / Environment \u914D\u7F6E\u793A\u4F8B
 
 - This is an ignored managed cloud environment example. Copy \`environments/_examples/example-env/\`
-  to \`environments/example-env/\` to enable it, then add \`"environment": "example-env"\` to \`agent.json\`.
-  \u8FD9\u662F\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\u7684\u6258\u7BA1\u4E91\u73AF\u5883\u793A\u4F8B\u3002\u590D\u5236\u5230 \`environments/example-env/\` \u540E\u542F\u7528\uFF0C\u518D\u5728 Agent \u4E2D\u6DFB\u52A0\u4E0A\u8FF0\u5F15\u7528\u3002
+  to \`environments/example-env/\`, then run Build. An unset \`agent.json.environment\` is linked to the sole local Environment.
+  With multiple local Environments, set \`"environment": "example-env"\` explicitly; existing selections are preserved.
+  \u8FD9\u662F\u4E0D\u53C2\u4E0E\u6784\u5EFA/\u53D1\u5E03\u7684\u6258\u7BA1\u4E91\u73AF\u5883\u793A\u4F8B\u3002\u590D\u5236\u5230 \`environments/example-env/\` \u540E\u8FD0\u884C Build\uFF1B\u672A\u6307\u5B9A\u73AF\u5883\u65F6\u81EA\u52A8\u5173\u8054\u552F\u4E00\u5019\u9009\uFF0C\u591A\u4E2A\u5019\u9009\u9700\u663E\u5F0F\u9009\u62E9\uFF0C\u5DF2\u6709\u5F15\u7528\u4E0D\u8986\u76D6\u3002
   Keep \`id\` equal to the directory name. / ID \u5E94\u4E0E\u76EE\u5F55\u540D\u4E00\u81F4\u3002
 - Optional \`config\` fields include \`networking\`, \`packages\`, and \`setup_script\`.
   \`config\` \u53EF\u6309\u9700\u589E\u52A0\u7F51\u7EDC\u7B56\u7565\u3001\u4F9D\u8D56\u5305\u548C\u521D\u59CB\u5316\u811A\u672C\uFF0C\u4F8B\u5982\uFF1A
@@ -198,8 +200,8 @@ ${JSON.stringify({ type: "cloud", packages: { pip: ["requests"] }, setup_script:
   packages/scripts take effect on the remote platform, not on your computer during Init/Build.
   \u4E0A\u9762\u7684\u7247\u6BB5\u53EA\u66FF\u6362 \`config\`\u3002Init/Build \u4E0D\u4F1A\u5728\u672C\u673A\u5B89\u88C5\u4F9D\u8D56\u6216\u6267\u884C\u811A\u672C\uFF1B\u8FDC\u7AEF\u662F\u5426\u652F\u6301\u4EE5 Provider \u4E3A\u51C6\u3002
 - Init leaves \`agent.json\` unchanged and only creates ignored resource examples.
-  Moving a declaration outside \`_examples/\` enables it for Build/Publish, even without an Agent reference.
-  Init \u4E0D\u6DFB\u52A0 Agent \u8D44\u6E90\u5F15\u7528\u3002\u5C06\u58F0\u660E\u79FB\u5230 \`_examples/\` \u5916\u5373\u4F1A\u8FDB\u5165\u6784\u5EFA/\u53D1\u5E03\u8303\u56F4\uFF0C\u5373\u4F7F\u5C1A\u672A\u914D\u7F6E Agent \u5F15\u7528\u3002
+  Moving a declaration outside \`_examples/\` enables it for Build/Publish; Build also fills in the owning Agent's missing reference.
+  Init \u4E0D\u6DFB\u52A0 Agent \u8D44\u6E90\u5F15\u7528\u3002\u5C06\u58F0\u660E\u79FB\u5230 \`_examples/\` \u5916\u540E\uFF0CBuild \u4F1A\u8865\u9F50\u6240\u5C5E Agent \u7684\u5F15\u7528\u5E76\u7EB3\u5165\u6784\u5EFA/\u53D1\u5E03\u3002
 - Delete this ignored example directory if not needed. For an enabled Environment, also remove its Agent reference.
   \u4E0D\u9700\u8981\u65F6\u53EF\u76F4\u63A5\u5220\u9664\u672C\u793A\u4F8B\u76EE\u5F55\uFF1B\u82E5\u5DF2\u7ECF\u542F\u7528\uFF0C\u8FD8\u9700\u5220\u9664 Agent \u7684 Environment \u5F15\u7528\u3002
 `
@@ -438,6 +440,23 @@ async function resolveDirectoryProjectRoot(input = ".") {
   const root = resolve2(input);
   const details = await stat(root).catch(() => null);
   if (!details?.isDirectory()) throw new UserError(`Project directory does not exist: ${root}`);
+  if (!await pathExists(resolve2(root, PROJECT_METADATA_FILE))) {
+    let ancestor = dirname(root);
+    while (ancestor !== root) {
+      if (await pathExists(resolve2(ancestor, PROJECT_METADATA_FILE))) {
+        const quotedRoot = `'${ancestor.replaceAll("'", "'\\''")}'`;
+        throw new UserError(
+          `Not a project root: ${root} (${PROJECT_METADATA_FILE} is missing).
+Project root: ${ancestor}
+Run from the project root: cd ${quotedRoot}
+Or specify the project directory: --project ${quotedRoot}`
+        );
+      }
+      const parent = dirname(ancestor);
+      if (parent === ancestor) break;
+      ancestor = parent;
+    }
+  }
   return root;
 }
 async function inspectDirectoryProject(projectDirectory = ".") {
@@ -804,7 +823,7 @@ async function assembleProject(projectRoot, sourceFiles, metadataOverrides) {
   for (const skill of skills) {
     if (skillById.has(skill.id)) throw new UserError(`Duplicate local skill id: ${skill.id}`);
     skillById.set(skill.id, skill);
-    if (skill.ownerAgent && skill.inferred) {
+    if (skill.ownerAgent) {
       autoAssociateSkill(skill, projectRoot, agents, agentSources, autoAssociations);
     }
   }
@@ -850,9 +869,7 @@ async function assembleProject(projectRoot, sourceFiles, metadataOverrides) {
     const key = `${resource.type}:${resource.id}`;
     if (resourceKeys.has(key)) throw new UserError(`Duplicate ${resource.type} id: ${resource.id}`);
     resourceKeys.add(key);
-    if (resource.type === "file" && resource.owner_agent && resource.inferred) {
-      autoAssociateFile(resource, projectRoot, agents, agentSources, autoAssociations);
-    }
+    autoAssociateDirectoryResource(resource, resources, projectRoot, agents, agentSources, autoAssociations);
     if (resource.owner_agent && isDirectoryResourceShared(resource.type, resource.id, resource.owner_agent, agents, project)) {
       const spec = DIRECTORY_RESOURCE_SPECS[resource.type];
       moves.push({
@@ -1120,6 +1137,43 @@ function autoAssociateSkill(skill, projectRoot, agents, agentSources, autoAssoci
     message: `Skill '${skill.id}' will be added to agents/${ownerAgent}/agent.json.`
   });
 }
+function autoAssociateDirectoryResource(resource, resources, projectRoot, agents, agentSources, autoAssociations) {
+  if (resource.type === "file") {
+    autoAssociateFile(resource, projectRoot, agents, agentSources, autoAssociations);
+    return;
+  }
+  const ownerAgent = resource.owner_agent;
+  if (!ownerAgent) return;
+  const agent = agents[ownerAgent];
+  const agentSource = agentSources.get(ownerAgent);
+  if (!agent || !agentSource) return;
+  const agentPath = `agents/${ownerAgent}/agent.json`;
+  if (resource.type === "memory_store") {
+    if (agent.memory_stores !== void 0 && !Array.isArray(agent.memory_stores)) return;
+    const references = Array.isArray(agent.memory_stores) ? agent.memory_stores : [];
+    if (references.includes(resource.id)) return;
+    agent.memory_stores = [...references, resource.id];
+    agentSource.memory_stores = structuredClone(agent.memory_stores);
+  } else {
+    if (agent[resource.type] !== void 0) return;
+    const candidates = resources.filter(
+      (candidate) => candidate.owner_agent === ownerAgent && candidate.type === resource.type
+    );
+    if (candidates.length > 1) {
+      throw new UserError(
+        `${agentPath}: multiple local ${resource.type} resources (${candidates.map((candidate) => candidate.id).join(", ")}). Set '${resource.type}' explicitly to choose one.`
+      );
+    }
+    agent[resource.type] = resource.id;
+    agentSource[resource.type] = resource.id;
+  }
+  planJsonWrite(autoAssociations, projectRoot, resolve2(projectRoot, agentPath), agentSource);
+  autoAssociations.warnings.push({
+    severity: "warning",
+    code: `project.${resource.type}.agent_link.inferred`,
+    message: `${resource.type} '${resource.id}' will be added to ${agentPath}.`
+  });
+}
 function autoAssociateFile(resource, projectRoot, agents, agentSources, autoAssociations) {
   const ownerAgent = resource.owner_agent;
   if (!ownerAgent) return;

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.0",
+  "version": "0.7.2",
   "description": "OpenAgentPack SDK (Node-compatible runtime)",
   "license": "Apache-2.0",
   "keywords": [