alibabacloud-agentcore-sdk 0.1.4 → 0.1.6

package/dist/chunk-MXPHQGBQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skill/loader.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { lstat, mkdir, mkdtemp, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';\nimport { basename, dirname, join, posix, resolve } from 'node:path';\nimport { fromBuffer, type Entry, type ZipFile } from 'yauzl';\nimport { parseDocument } from 'yaml';\nimport type { SkillArtifact } from '../controlplane/client';\nimport { ConfigError, ResourceNotConfiguredError } from '../errors';\nimport { nullLogger, type Logger } from '../logging';\n\nconst MAX_BYTES = 10 * 1024 * 1024;\nconst METADATA = '.agentcore-skill.json';\nconst writes = new Map<string, Promise<void>>();\nexport interface Skill {\n  readonly name: string;\n  readonly description: string;\n  readonly version: string;\n  readonly instruction: string;\n  readonly root: string;\n  readonly files: readonly string[];\n  readonly source: 'local' | 'agentcore';\n  readonly digest?: string;\n  readonly workspaceId?: string;\n}\nexport interface SkillProvider { getSkill(name: string, version?: string): Promise<SkillArtifact>; }\nexport interface SkillsOptions {\n  workspaceDir?: string;\n  runtime?: () => Promise<{ workspaceId: string; provider: SkillProvider }>;\n  logger?: Logger;\n}\n\nexport class Skills {\n  private readonly pins = new Map<string, Promise<Skill>>();\n  private readonly workspace: string;\n  private readonly logger: Logger;\n  constructor(private readonly options: SkillsOptions = {}) {\n    this.workspace = resolve(options.workspaceDir ?? process.env.AGENTCORE_SKILL_WORKSPACE_DIR ?? '.skills/.agentcore-managed');\n    this.logger = options.logger ?? nullLogger;\n  }\n  async local(root: string): Promise<Skill[]> {\n    this.logger.info('agentcore.skill.local.load.started', { root });\n    try {\n      root = resolve(root);\n      if (!(await lstat(root)).isDirectory()) throw new ConfigError('local Skill root is not a directory');\n      const entries = await readdir(root, { withFileTypes: true });\n      const directories = entries.some((entry) => entry.name === 'SKILL.md') ? [root] : entries.sort((a, b) => a.name.localeCompare(b.name)).flatMap((entry) => {\n        if (entry.isSymbolicLink()) throw new ConfigError('local Skill root must not contain symbolic-link Skills');\n        return entry.isDirectory() ? [join(root, entry.name)] : [];\n      });\n      const result: Skill[] = [];\n      for (const directory of directories) {\n        if ((await readdir(directory)).includes('SKILL.md')) result.push(await loadDirectory(directory));\n      }\n      this.logger.info('agentcore.skill.local.load.succeeded', { root, skill_count: result.length }); return result;\n    } catch (error) { this.logger.warn('agentcore.skill.local.load.failed', { root, error_type: error instanceof Error ? error.name : 'Error' }); throw error; }\n  }\n  async managed(name: string, options: { version?: string } = {}): Promise<Skill> {\n    if (!this.options.runtime) throw new ResourceNotConfiguredError('managed Skill runtime is not configured');\n    const { workspaceId, provider } = await this.options.runtime();\n    component(name, 'name'); component(workspaceId, 'workspace ID');\n    if (options.version !== undefined) component(options.version, 'version');\n    const key = JSON.stringify([workspaceId, name, options.version]);\n    const cached = this.pins.get(key); if (cached) return cached;\n    const pending = (async () => {\n      this.logger.info('agentcore.skill.managed.load.started', { workspace_id: workspaceId, name, version: options.version ?? 'latest' });\n      const artifact = await provider.getSkill(name, options.version); component(artifact.version, 'version');\n      const files = await unpackArchive(artifact.archive, name);\n      const hash = createHash('sha256');\n      for (const [path, data] of [...files.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) hash.update(path).update('\\0').update(data).update('\\0');\n      const digest = hash.digest('hex');\n      const target = join(this.workspace, workspaceId, name, artifact.version);\n      const metadata = { source: 'agentcore', workspaceId, name, version: artifact.version, digest };\n      // Serialize writes to the same named version across Core instances in this process.\n      const write = (writes.get(target) ?? Promise.resolve()).catch(() => undefined).then(() => materialize(target, files, metadata));\n      writes.set(target, write);\n      try { await write; } finally { if (writes.get(target) === write) writes.delete(target); }\n      const sourceFiles = ['SKILL.md', ...[...files.keys()].filter((path) => path !== 'SKILL.md').sort()];\n      const skill = Object.freeze({ ...await loadDirectory(target, sourceFiles), ...metadata, source: 'agentcore' as const });\n      this.logger.info('agentcore.skill.managed.load.succeeded', { workspace_id: workspaceId, name, version: artifact.version, digest });\n      return skill;\n    })();\n    this.pins.set(key, pending);\n    try { return await pending; } catch (error) {\n      this.pins.delete(key); this.logger.warn('agentcore.skill.managed.load.failed', { workspace_id: workspaceId, name, error_type: error instanceof Error ? error.name : 'Error' }); throw error;\n    }\n  }\n}\n\nfunction component(value: string, label: string): void {\n  if (!value.trim() || /[\\\\/:\\0]/.test(value) || value === '.' || value === '..') throw new ConfigError(`managed Skill ${label} is invalid`);\n}\nfunction safePath(path: string): void {\n  if (!path || /[\\\\:\\0]/.test(path) || posix.isAbsolute(path) || path !== posix.normalize(path) || path.split('/').some((part) => part === '.' || part === '..') || path === METADATA) throw new ConfigError('managed Skill contains an unsafe resource path');\n}\nexport async function unpackArchive(archive: Uint8Array, name?: string, maxBytes = MAX_BYTES): Promise<Map<string, Buffer>> {\n  if (!archive.length || archive.length > maxBytes) throw new ConfigError('Resource archive exceeds the size limit');\n  try {\n    const zip = await new Promise<ZipFile>((accept, reject) => fromBuffer(Buffer.from(archive), { lazyEntries: true, strictFileNames: true }, (error, value) => error ? reject(error) : accept(value)));\n    const files = new Map<string, Buffer>(); let total = 0;\n    await new Promise<void>((accept, reject) => {\n      zip.on('error', reject); zip.on('end', accept);\n      zip.on('entry', (entry: Entry) => { void (async () => {\n        if (entry.fileName.endsWith('/')) return;\n        safePath(entry.fileName);\n        if (name !== undefined && !entry.fileName.startsWith(`${name}/`)) throw new ConfigError('managed Skill package must use the Skill name as its root directory');\n        const path = name === undefined ? entry.fileName : entry.fileName.slice(name.length + 1); safePath(path);\n        if (files.has(path)) throw new ConfigError('managed Skill package contains a duplicate path');\n        if (((entry.externalFileAttributes >>> 16) & 0xf000) === 0xa000) throw new ConfigError('Skill directories must not contain symbolic links');\n        if (entry.uncompressedSize > maxBytes - total) throw new ConfigError('Resource content exceeds the size limit');\n        const stream = await new Promise<NodeJS.ReadableStream>((resolve, reject) => zip.openReadStream(entry, (error, stream) => error ? reject(error) : resolve(stream)));\n        const chunks: Buffer[] = [];\n        for await (const chunk of stream) { const data = Buffer.from(chunk); total += data.length; if (total > maxBytes) throw new ConfigError('Resource content exceeds the size limit'); chunks.push(data); }\n        files.set(path, Buffer.concat(chunks));\n      })().then(() => zip.readEntry(), (error) => { zip.close(); reject(error); }); });\n      zip.readEntry();\n    });\n    if (name !== undefined && !files.has('SKILL.md')) throw new ConfigError(`managed Skill package does not contain ${name}/SKILL.md`);\n    for (const path of files.keys()) {\n      let parent = posix.dirname(path);\n      while (parent !== '.') { if (files.has(parent)) throw new ConfigError('managed Skill contains a colliding resource path'); parent = posix.dirname(parent); }\n    }\n    return files;\n  } catch (error) { if (error instanceof ConfigError) throw error; throw new ConfigError('managed Skill package is not a valid ZIP archive'); }\n}\n\n/** @internal Materialize a static template Skill through the existing atomic writer. */\nexport async function materializeTemplateSkill(target: string, name: string, files: Map<string, Buffer>, metadata: Record<string, string>): Promise<Skill> {\n  if (!files.has('SKILL.md')) throw new ConfigError(`Static Skill ${JSON.stringify(name)} has no SKILL.md`);\n  const write = (writes.get(target) ?? Promise.resolve()).catch(() => undefined).then(() => materialize(target, files, metadata));\n  writes.set(target, write);\n  try { await write; } finally { if (writes.get(target) === write) writes.delete(target); }\n  return Object.freeze({ ...await loadDirectory(target), name, workspaceId: metadata.workspaceId, digest: metadata.digest });\n}\n\nasync function materialize(target: string, files: Map<string, Buffer>, metadata: Record<string, string>): Promise<void> {\n  try {\n    const stat = await lstat(target);\n    if (stat.isDirectory() && !stat.isSymbolicLink()) {\n      const existing: unknown = JSON.parse(await readFile(join(target, METADATA), 'utf8'));\n      if (JSON.stringify(existing) === JSON.stringify(metadata)) return;\n    }\n  } catch (error) { if (!(error instanceof SyntaxError) && (error as NodeJS.ErrnoException).code !== 'ENOENT') throw error; }\n  await mkdir(dirname(target), { recursive: true });\n  const temporary = await mkdtemp(join(dirname(target), '.skill-'));\n  try {\n    for (const [path, content] of files) { const destination = join(temporary, path); await mkdir(dirname(destination), { recursive: true }); await writeFile(destination, content); }\n    await writeFile(join(temporary, METADATA), JSON.stringify(metadata));\n    await loadDirectory(temporary); // Do not replace a working version with invalid SKILL.md.\n    await rm(target, { recursive: true, force: true });\n    await rename(temporary, target);\n  } finally { await rm(temporary, { recursive: true, force: true }); }\n}\n\nasync function loadDirectory(root: string, sourceFiles?: readonly string[]): Promise<Skill> {\n  const files: string[] = []; let total = 0;\n  async function walk(directory: string, prefix = ''): Promise<void> {\n    for (const entry of (await readdir(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {\n      if (entry.isSymbolicLink()) throw new ConfigError('Skill directories must not contain symbolic links');\n      const name = prefix + entry.name;\n      if (entry.isDirectory()) await walk(join(directory, entry.name), `${name}/`);\n      else if (entry.isFile() && entry.name !== METADATA) { total += (await lstat(join(directory, entry.name))).size; if (total > MAX_BYTES) throw new ConfigError('Skill content exceeds the 10 MiB size limit'); files.push(name); }\n    }\n  }\n  if (sourceFiles) {\n    // Managed packages track source files, not files generated by command execution.\n    for (const name of sourceFiles) {\n      const entry = await lstat(join(root, name));\n      if (entry.isSymbolicLink() || !entry.isFile()) throw new ConfigError('managed Skill workspace is missing a source file');\n      files.push(name);\n    }\n  } else await walk(root);\n  const instruction = new TextDecoder('utf8', { fatal: true }).decode(await readFile(join(root, 'SKILL.md')));\n  const match = /^---\\s*\\n([\\s\\S]*?)\\n---(?:\\s*\\n|$)/.exec(instruction);\n  const metadata: Record<string, string> = {};\n  if (match) {\n    const document = parseDocument(match[1]!);\n    if (document.errors.length) throw new ConfigError('SKILL.md contains invalid YAML frontmatter');\n    let value: unknown;\n    try { value = document.toJS({ maxAliasCount: 0 }) ?? {}; } catch { throw new ConfigError('SKILL.md contains invalid YAML frontmatter'); }\n    if (!value || typeof value !== 'object' || Array.isArray(value)) throw new ConfigError('SKILL.md frontmatter must be an object');\n    for (const key of ['name', 'description', 'version']) {\n      const item = (value as Record<string, unknown>)[key];\n      if (item !== undefined && item !== null) { if (typeof item !== 'string') throw new ConfigError(`SKILL.md frontmatter ${key} must be a string`); metadata[key] = item; }\n    }\n  }\n  return Object.freeze({ name: metadata.name || basename(root), description: metadata.description || '', version: metadata.version || '', instruction, root, files: Object.freeze(files), source: 'local' as const });\n}\n"],"mappings":"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","names":["resolve","reject","stream"]}

package/dist/{chunk-6NNPSP3O.js → chunk-XW6YGVZO.js}

@@ -6,10 +6,12 @@ import {
 import { AsyncLocalStorage } from "async_hooks";
 import { inspect } from "util";
 var RequestContext = class {
-  headers;
-  constructor(headers) {
+  constructor(headers, signal) {
+    this.signal = signal;
     this.headers = Object.freeze(Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v])));
   }
+  signal;
+  headers;
   [inspect.custom]() {
     return "RequestContext(headers=<redacted>)";
   }
@@ -32,4 +34,4 @@ export {
   currentContext,
   useContext
 };
-//# sourceMappingURL=chunk-6NNPSP3O.js.map
+//# sourceMappingURL=chunk-XW6YGVZO.js.map

package/dist/chunk-XW6YGVZO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { inspect } from 'node:util';\nimport { ContextError } from '../errors';\n\nexport class RequestContext {\n  readonly headers: Readonly<Record<string, string>>;\n  constructor(headers: Readonly<Record<string, string>>, readonly signal?: AbortSignal) {\n    this.headers = Object.freeze(Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v])));\n  }\n  [inspect.custom](): string { return 'RequestContext(headers=<redacted>)'; }\n  toJSON(): string { return this[inspect.custom](); }\n}\nconst context = new AsyncLocalStorage<RequestContext>();\nexport function currentContext(required = true): RequestContext | undefined {\n  const value = context.getStore();\n  if (!value && required) throw new ContextError('no AgentCore request context is active');\n  return value;\n}\nexport function useContext<T>(value: RequestContext, callback: () => T): T {\n  return context.run(value, callback);\n}\n"],"mappings":";;;;;AAAA,SAAS,yBAAyB;AAClC,SAAS,eAAe;AAGjB,IAAM,iBAAN,MAAqB;AAAA,EAE1B,YAAY,SAAoD,QAAsB;AAAtB;AAC9D,SAAK,UAAU,OAAO,OAAO,OAAO,YAAY,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;AAAA,EAChH;AAAA,EAFgE;AAAA,EADvD;AAAA,EAIT,CAAC,QAAQ,MAAM,IAAY;AAAE,WAAO;AAAA,EAAsC;AAAA,EAC1E,SAAiB;AAAE,WAAO,KAAK,QAAQ,MAAM,EAAE;AAAA,EAAG;AACpD;AACA,IAAM,UAAU,IAAI,kBAAkC;AAC/C,SAAS,eAAe,WAAW,MAAkC;AAC1E,QAAM,QAAQ,QAAQ,SAAS;AAC/B,MAAI,CAAC,SAAS,SAAU,OAAM,IAAI,aAAa,wCAAwC;AACvF,SAAO;AACT;AACO,SAAS,WAAc,OAAuB,UAAsB;AACzE,SAAO,QAAQ,IAAI,OAAO,QAAQ;AACpC;","names":[]}

package/dist/{client-pDzS7EZR.d.ts → client-D4f63nzj.d.ts}

@@ -1,7 +1,7 @@
 import { inspect } from 'node:util';
 import { L as Logger } from './logging-C8GLLg1f.js';
 import { A as AgentConfig } from './config-CMkmMtx1.js';
-import { ModelDescriptor } from './controlplane/index.js';
+import { M as ModelDescriptor } from './index-CkDNn3fW.js';
 
 type ModelProtocol = 'openai' | 'anthropic';
 type ModelMessage = {

package/dist/{client-DDU4-ygJ.d.cts → client-K_TFV6Ea.d.cts}

@@ -1,7 +1,7 @@
 import { inspect } from 'node:util';
 import { L as Logger } from './logging-C8GLLg1f.cjs';
 import { A as AgentConfig } from './config-CMkmMtx1.cjs';
-import { ModelDescriptor } from './controlplane/index.cjs';
+import { M as ModelDescriptor } from './index-Dsu71P1g.cjs';
 
 type ModelProtocol = 'openai' | 'anthropic';
 type ModelMessage = {

package/dist/collaboration/index.d.cts

@@ -1,10 +1,10 @@
 import { inspect } from 'node:util';
-import { C as ConfigError, a as ContextError, A as AgentCoreError } from '../errors-BGfCbCgs.cjs';
-export { b as CollaborationOptions, c as CollaborationRuntime, W as Worker } from '../errors-BGfCbCgs.cjs';
+import { C as ConfigError, a as ContextError, A as AgentCoreError } from '../errors-BA8gNCmW.cjs';
+export { b as CollaborationOptions, c as CollaborationRuntime, W as Worker } from '../errors-BA8gNCmW.cjs';
 import '../common-BSXkQfxI.cjs';
 import '../logging-C8GLLg1f.cjs';
-import '../loader-eWuJ2GSL.cjs';
-import '../controlplane/index.cjs';
+import '../loader-kC1qeJWI.cjs';
+import '../index-Dsu71P1g.cjs';
 import '../access-key-CkoHq3S8.cjs';
 
 declare class CollaborationTurnContext {

package/dist/collaboration/index.d.ts

@@ -1,10 +1,10 @@
 import { inspect } from 'node:util';
-import { C as ConfigError, a as ContextError, A as AgentCoreError } from '../errors-D_809AqR.js';
-export { b as CollaborationOptions, c as CollaborationRuntime, W as Worker } from '../errors-D_809AqR.js';
+import { C as ConfigError, a as ContextError, A as AgentCoreError } from '../errors-DAxP-nfs.js';
+export { b as CollaborationOptions, c as CollaborationRuntime, W as Worker } from '../errors-DAxP-nfs.js';
 import '../common-BSXkQfxI.js';
 import '../logging-C8GLLg1f.js';
-import '../loader-DrIQ37nm.js';
-import '../controlplane/index.js';
+import '../loader-BV55JAVK.js';
+import '../index-CkDNn3fW.js';
 import '../access-key-CkoHq3S8.js';
 
 declare class CollaborationTurnContext {

package/dist/{context-M9rOTifU.d.cts → context-CVUx3RZg.d.cts}

@@ -1,8 +1,9 @@
 import { inspect } from 'node:util';
 
 declare class RequestContext {
+    readonly signal?: AbortSignal | undefined;
     readonly headers: Readonly<Record<string, string>>;
-    constructor(headers: Readonly<Record<string, string>>);
+    constructor(headers: Readonly<Record<string, string>>, signal?: AbortSignal | undefined);
     [inspect.custom](): string;
     toJSON(): string;
 }

package/dist/{context-M9rOTifU.d.ts → context-CVUx3RZg.d.ts}

@@ -1,8 +1,9 @@
 import { inspect } from 'node:util';
 
 declare class RequestContext {
+    readonly signal?: AbortSignal | undefined;
     readonly headers: Readonly<Record<string, string>>;
-    constructor(headers: Readonly<Record<string, string>>);
+    constructor(headers: Readonly<Record<string, string>>, signal?: AbortSignal | undefined);
     [inspect.custom](): string;
     toJSON(): string;
 }

package/dist/controlplane/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkJK6KPDVWcjs = require('../chunk-JK6KPDVW.cjs');
+var _chunkEYDYQCSJcjs = require('../chunk-EYDYQCSJ.cjs');
 require('../chunk-RJCDBVZ6.cjs');
 require('../chunk-25KH5XKG.cjs');
 require('../chunk-KQTZUIMI.cjs');
@@ -8,5 +8,5 @@ require('../chunk-NXMTTQQK.cjs');
 require('../chunk-V4A6MJ42.cjs');
 
 
-exports.AgentCoreControlPlane = _chunkJK6KPDVWcjs.AgentCoreControlPlane;
+exports.AgentCoreControlPlane = _chunkEYDYQCSJcjs.AgentCoreControlPlane;
 //# sourceMappingURL=index.cjs.map

package/dist/controlplane/index.d.cts

@@ -1,66 +1,4 @@
-import { A as AccessKeyCredential, C as CredentialProvider } from '../access-key-CkoHq3S8.cjs';
-import { L as Logger } from '../logging-C8GLLg1f.cjs';
+export { A as AgentCoreControlPlane, b as ControlPlaneOptions, C as CredentialMetadata, a as MCPDescriptor, M as ModelDescriptor, S as SkillArtifact } from '../index-Dsu71P1g.cjs';
+import '../access-key-CkoHq3S8.cjs';
 import 'node:util';
-
-interface ModelDescriptor {
-    readonly connectionId: string;
-    readonly connectionName: string;
-    readonly protocol: string;
-    readonly providerType: string;
-    readonly modelId: string;
-    readonly modelName: string;
-    readonly contextSize?: number;
-    readonly maxTokens?: number;
-    readonly capabilities: Readonly<Record<string, boolean>>;
-}
-interface MCPDescriptor {
-    readonly mcpServerId: string;
-    readonly name: string;
-    readonly protocol: string;
-    readonly type: string;
-    readonly status: string;
-}
-interface SkillArtifact {
-    version: string;
-    archive: Uint8Array;
-}
-interface CredentialMetadata {
-    readonly credentialId: string;
-    readonly name: string;
-    readonly credentialType: string;
-    readonly resourceScope: string;
-    readonly resourceRefs: ReadonlyArray<{
-        resourceType: string;
-        resourceId: string;
-    }>;
-}
-interface ControlPlaneOptions {
-    workspaceId: string;
-    regionId: string;
-    accessKeyCredential?: AccessKeyCredential;
-    resourceSTSProvider?: CredentialProvider;
-    endpoint?: string;
-    logger?: Logger;
-}
-declare class AgentCoreControlPlane {
-    private readonly options;
-    readonly workspaceId: string;
-    readonly regionId: string;
-    private readonly endpoint?;
-    private readonly protocol?;
-    private discoveredEndpoint?;
-    private readonly logger;
-    private readonly lifetime;
-    constructor(options: ControlPlaneOptions);
-    resolveModel(connectionName: string, modelName?: string): Promise<ModelDescriptor>;
-    resolveMCP(name: string): Promise<MCPDescriptor>;
-    getSkill(name: string, version?: string): Promise<SkillArtifact>;
-    close(): void;
-    resolveCredential(name: string): Promise<CredentialMetadata>;
-    private runtimeOptions;
-    private client;
-    private invoke;
-    private downloadSkill;
-}
-
-export { AgentCoreControlPlane, type ControlPlaneOptions, type CredentialMetadata, type MCPDescriptor, type ModelDescriptor, type SkillArtifact };
+import '../logging-C8GLLg1f.cjs';

package/dist/controlplane/index.d.ts

@@ -1,66 +1,4 @@
-import { A as AccessKeyCredential, C as CredentialProvider } from '../access-key-CkoHq3S8.js';
-import { L as Logger } from '../logging-C8GLLg1f.js';
+export { A as AgentCoreControlPlane, b as ControlPlaneOptions, C as CredentialMetadata, a as MCPDescriptor, M as ModelDescriptor, S as SkillArtifact } from '../index-CkDNn3fW.js';
+import '../access-key-CkoHq3S8.js';
 import 'node:util';
-
-interface ModelDescriptor {
-    readonly connectionId: string;
-    readonly connectionName: string;
-    readonly protocol: string;
-    readonly providerType: string;
-    readonly modelId: string;
-    readonly modelName: string;
-    readonly contextSize?: number;
-    readonly maxTokens?: number;
-    readonly capabilities: Readonly<Record<string, boolean>>;
-}
-interface MCPDescriptor {
-    readonly mcpServerId: string;
-    readonly name: string;
-    readonly protocol: string;
-    readonly type: string;
-    readonly status: string;
-}
-interface SkillArtifact {
-    version: string;
-    archive: Uint8Array;
-}
-interface CredentialMetadata {
-    readonly credentialId: string;
-    readonly name: string;
-    readonly credentialType: string;
-    readonly resourceScope: string;
-    readonly resourceRefs: ReadonlyArray<{
-        resourceType: string;
-        resourceId: string;
-    }>;
-}
-interface ControlPlaneOptions {
-    workspaceId: string;
-    regionId: string;
-    accessKeyCredential?: AccessKeyCredential;
-    resourceSTSProvider?: CredentialProvider;
-    endpoint?: string;
-    logger?: Logger;
-}
-declare class AgentCoreControlPlane {
-    private readonly options;
-    readonly workspaceId: string;
-    readonly regionId: string;
-    private readonly endpoint?;
-    private readonly protocol?;
-    private discoveredEndpoint?;
-    private readonly logger;
-    private readonly lifetime;
-    constructor(options: ControlPlaneOptions);
-    resolveModel(connectionName: string, modelName?: string): Promise<ModelDescriptor>;
-    resolveMCP(name: string): Promise<MCPDescriptor>;
-    getSkill(name: string, version?: string): Promise<SkillArtifact>;
-    close(): void;
-    resolveCredential(name: string): Promise<CredentialMetadata>;
-    private runtimeOptions;
-    private client;
-    private invoke;
-    private downloadSkill;
-}
-
-export { AgentCoreControlPlane, type ControlPlaneOptions, type CredentialMetadata, type MCPDescriptor, type ModelDescriptor, type SkillArtifact };
+import '../logging-C8GLLg1f.js';

package/dist/controlplane/index.js

@@ -1,6 +1,6 @@
 import {
   AgentCoreControlPlane
-} from "../chunk-7UBN3SJI.js";
+} from "../chunk-I2SSXKT7.js";
 import "../chunk-NRYDUATX.js";
 import "../chunk-76NTQYJB.js";
 import "../chunk-AX3NM2DK.js";

package/dist/{errors-BGfCbCgs.d.cts → errors-BA8gNCmW.d.cts}

@@ -1,6 +1,6 @@
 import { T as Tool } from './common-BSXkQfxI.cjs';
 import { L as Logger } from './logging-C8GLLg1f.cjs';
-import { S as Skill } from './loader-eWuJ2GSL.cjs';
+import { S as Skill } from './loader-kC1qeJWI.cjs';
 
 /** Stable base-SDK contract; Worker implementation lives in the independently installed addon. */
 interface Worker {

package/dist/{errors-D_809AqR.d.ts → errors-DAxP-nfs.d.ts}

@@ -1,6 +1,6 @@
 import { T as Tool } from './common-BSXkQfxI.js';
 import { L as Logger } from './logging-C8GLLg1f.js';
-import { S as Skill } from './loader-DrIQ37nm.js';
+import { S as Skill } from './loader-BV55JAVK.js';
 
 /** Stable base-SDK contract; Worker implementation lives in the independently installed addon. */
 interface Worker {

package/dist/index-CkDNn3fW.d.ts

@@ -0,0 +1,71 @@
+import { A as AccessKeyCredential, C as CredentialProvider } from './access-key-CkoHq3S8.js';
+import { L as Logger } from './logging-C8GLLg1f.js';
+
+interface ModelDescriptor {
+    readonly connectionId: string;
+    readonly connectionName: string;
+    readonly protocol: string;
+    readonly providerType: string;
+    readonly modelId: string;
+    readonly modelName: string;
+    readonly contextSize?: number;
+    readonly maxTokens?: number;
+    readonly capabilities: Readonly<Record<string, boolean>>;
+}
+interface MCPDescriptor {
+    readonly mcpServerId: string;
+    readonly name: string;
+    readonly protocol: string;
+    readonly type: string;
+    readonly status: string;
+}
+interface SkillArtifact {
+    version: string;
+    archive: Uint8Array;
+}
+interface TemplateArtifact {
+    version: string;
+    archive: Uint8Array;
+}
+interface CredentialMetadata {
+    readonly credentialId: string;
+    readonly name: string;
+    readonly credentialType: string;
+    readonly resourceScope: string;
+    readonly resourceRefs: ReadonlyArray<{
+        resourceType: string;
+        resourceId: string;
+    }>;
+}
+interface ControlPlaneOptions {
+    workspaceId: string;
+    regionId: string;
+    accessKeyCredential?: AccessKeyCredential;
+    resourceSTSProvider?: CredentialProvider;
+    endpoint?: string;
+    logger?: Logger;
+}
+declare class AgentCoreControlPlane {
+    private readonly options;
+    readonly workspaceId: string;
+    readonly regionId: string;
+    private readonly endpoint?;
+    private readonly protocol?;
+    private discoveredEndpoint?;
+    private readonly logger;
+    private readonly lifetime;
+    constructor(options: ControlPlaneOptions);
+    resolveModel(connectionName: string, modelName?: string): Promise<ModelDescriptor>;
+    resolveMCP(name: string): Promise<MCPDescriptor>;
+    getSkill(name: string, version?: string): Promise<SkillArtifact>;
+    resolveSkillVersion(name: string, selectorType: string, value: string): Promise<string>;
+    getTemplate(name: string, version?: string): Promise<TemplateArtifact>;
+    close(): void;
+    resolveCredential(name: string): Promise<CredentialMetadata>;
+    private runtimeOptions;
+    private client;
+    private invoke;
+    private downloadSkill;
+}
+
+export { AgentCoreControlPlane as A, type CredentialMetadata as C, type ModelDescriptor as M, type SkillArtifact as S, type TemplateArtifact as T, type MCPDescriptor as a, type ControlPlaneOptions as b };

package/dist/index-Dsu71P1g.d.cts

@@ -0,0 +1,71 @@
+import { A as AccessKeyCredential, C as CredentialProvider } from './access-key-CkoHq3S8.cjs';
+import { L as Logger } from './logging-C8GLLg1f.cjs';
+
+interface ModelDescriptor {
+    readonly connectionId: string;
+    readonly connectionName: string;
+    readonly protocol: string;
+    readonly providerType: string;
+    readonly modelId: string;
+    readonly modelName: string;
+    readonly contextSize?: number;
+    readonly maxTokens?: number;
+    readonly capabilities: Readonly<Record<string, boolean>>;
+}
+interface MCPDescriptor {
+    readonly mcpServerId: string;
+    readonly name: string;
+    readonly protocol: string;
+    readonly type: string;
+    readonly status: string;
+}
+interface SkillArtifact {
+    version: string;
+    archive: Uint8Array;
+}
+interface TemplateArtifact {
+    version: string;
+    archive: Uint8Array;
+}
+interface CredentialMetadata {
+    readonly credentialId: string;
+    readonly name: string;
+    readonly credentialType: string;
+    readonly resourceScope: string;
+    readonly resourceRefs: ReadonlyArray<{
+        resourceType: string;
+        resourceId: string;
+    }>;
+}
+interface ControlPlaneOptions {
+    workspaceId: string;
+    regionId: string;
+    accessKeyCredential?: AccessKeyCredential;
+    resourceSTSProvider?: CredentialProvider;
+    endpoint?: string;
+    logger?: Logger;
+}
+declare class AgentCoreControlPlane {
+    private readonly options;
+    readonly workspaceId: string;
+    readonly regionId: string;
+    private readonly endpoint?;
+    private readonly protocol?;
+    private discoveredEndpoint?;
+    private readonly logger;
+    private readonly lifetime;
+    constructor(options: ControlPlaneOptions);
+    resolveModel(connectionName: string, modelName?: string): Promise<ModelDescriptor>;
+    resolveMCP(name: string): Promise<MCPDescriptor>;
+    getSkill(name: string, version?: string): Promise<SkillArtifact>;
+    resolveSkillVersion(name: string, selectorType: string, value: string): Promise<string>;
+    getTemplate(name: string, version?: string): Promise<TemplateArtifact>;
+    close(): void;
+    resolveCredential(name: string): Promise<CredentialMetadata>;
+    private runtimeOptions;
+    private client;
+    private invoke;
+    private downloadSkill;
+}
+
+export { AgentCoreControlPlane as A, type CredentialMetadata as C, type ModelDescriptor as M, type SkillArtifact as S, type TemplateArtifact as T, type MCPDescriptor as a, type ControlPlaneOptions as b };