alibabacloud-agentcore-sdk 0.1.0

package/dist/model/index.d.ts

@@ -0,0 +1,129 @@
+import { a as ModelCallOptions } from '../client-pDzS7EZR.js';
+export { D as DirectModelOptions, H as HeadersProvider, M as ModelClient, b as ModelMessage, c as ModelParameters, d as ModelProtocol, e as ModelResponse, f as ModelSettings, m as managedModelProtocol, g as modelBaseURL } from '../client-pDzS7EZR.js';
+import * as _ai_sdk_provider from '@ai-sdk/provider';
+import { LanguageModelV3, EmbeddingModelV3 } from '@ai-sdk/provider';
+import * as ai from 'ai';
+import { ToolSet, ModelMessage, generateText, streamText, embedMany } from 'ai';
+import { inspect } from 'node:util';
+import { L as Logger } from '../logging-C8GLLg1f.js';
+import '../config-CMkmMtx1.js';
+import '../controlplane/index.js';
+import '../access-key-CkoHq3S8.js';
+
+interface DirectProviderOptions {
+    /** A configured AI SDK provider model. The provider owns its endpoint and auth. */
+    languageModel: LanguageModelV3;
+    embeddingModel?: EmbeddingModelV3;
+    timeoutMs?: number;
+    logger?: Logger;
+}
+type ProviderGenerateOptions<T extends ToolSet = ToolSet> = Omit<Parameters<typeof generateText<T>>[0], 'model' | 'messages' | 'prompt' | 'abortSignal'>;
+type ProviderStreamOptions<T extends ToolSet = ToolSet> = Omit<Parameters<typeof streamText<T>>[0], 'model' | 'messages' | 'prompt' | 'abortSignal'>;
+type ProviderEmbeddingOptions = Omit<Parameters<typeof embedMany>[0], 'model' | 'values' | 'abortSignal'>;
+/** Multi-provider Direct models use AI SDK messages/results, not a simulated OpenAI protocol. */
+declare class ProviderModelClient {
+    readonly settings: Readonly<{
+        model: string;
+        provider: string;
+    }>;
+    readonly languageModel: LanguageModelV3;
+    private readonly lifetime;
+    private readonly logger;
+    private readonly timeoutMs;
+    private readonly embeddingModel?;
+    constructor(options: DirectProviderOptions);
+    completion<T extends ToolSet = ToolSet>(messages: readonly ModelMessage[], parameters?: ProviderGenerateOptions<T>, options?: ModelCallOptions): Promise<ai.GenerateTextResult<T, ai.OutputInterface<string, string, any>>>;
+    invoke<T extends ToolSet = ToolSet>(messages: readonly ModelMessage[], parameters?: ProviderGenerateOptions<T>, options?: ModelCallOptions): Promise<ai.GenerateTextResult<T, ai.OutputInterface<string, string, any>>>;
+    stream<T extends ToolSet = ToolSet>(messages: readonly ModelMessage[], parameters?: ProviderStreamOptions<T>, options?: ModelCallOptions): AsyncGenerator<{
+        type: "text-start";
+        id: string;
+        providerMetadata?: ai.ProviderMetadata;
+    } | {
+        type: "text-end";
+        id: string;
+        providerMetadata?: ai.ProviderMetadata;
+    } | {
+        type: "text-delta";
+        id: string;
+        providerMetadata?: ai.ProviderMetadata;
+        text: string;
+    } | {
+        type: "reasoning-start";
+        id: string;
+        providerMetadata?: ai.ProviderMetadata;
+    } | {
+        type: "reasoning-end";
+        id: string;
+        providerMetadata?: ai.ProviderMetadata;
+    } | {
+        type: "reasoning-delta";
+        providerMetadata?: ai.ProviderMetadata;
+        id: string;
+        text: string;
+    } | {
+        type: "tool-input-start";
+        id: string;
+        toolName: string;
+        providerMetadata?: ai.ProviderMetadata;
+        toolMetadata?: _ai_sdk_provider.JSONObject;
+        providerExecuted?: boolean;
+        dynamic?: boolean;
+        title?: string;
+    } | {
+        type: "tool-input-end";
+        id: string;
+        providerMetadata?: ai.ProviderMetadata;
+    } | {
+        type: "tool-input-delta";
+        id: string;
+        delta: string;
+        providerMetadata?: ai.ProviderMetadata;
+    } | ({
+        type: "source";
+    } & _ai_sdk_provider.LanguageModelV3Source) | {
+        type: "file";
+        file: ai.Experimental_GeneratedImage;
+        providerMetadata?: ai.ProviderMetadata;
+    } | {
+        type: "start-step";
+        request: ai.LanguageModelRequestMetadata;
+        warnings: ai.CallWarning[];
+    } | {
+        type: "finish-step";
+        response: ai.LanguageModelResponseMetadata;
+        usage: ai.LanguageModelUsage;
+        finishReason: ai.FinishReason;
+        rawFinishReason: string | undefined;
+        providerMetadata: ai.ProviderMetadata | undefined;
+    } | {
+        type: "start";
+    } | {
+        type: "finish";
+        finishReason: ai.FinishReason;
+        rawFinishReason: string | undefined;
+        totalUsage: ai.LanguageModelUsage;
+    } | {
+        type: "abort";
+        reason?: string;
+    } | {
+        type: "raw";
+        rawValue: unknown;
+    } | ({
+        type: "tool-call";
+    } & ai.TypedToolCall<T>) | ({
+        type: "tool-result";
+    } & ai.TypedToolResult<T>) | ({
+        type: "tool-error";
+    } & ai.TypedToolError<T>) | ({
+        type: "tool-output-denied";
+    } & ai.StaticToolOutputDenied<T>) | ai.ToolApprovalRequestOutput<T>, void, unknown>;
+    embedding(input: string | readonly string[], parameters?: ProviderEmbeddingOptions, options?: ModelCallOptions): Promise<ai.EmbedManyResult>;
+    close(): void;
+    [inspect.custom](): string;
+    toJSON(): string;
+    private signal;
+    private request;
+    private failed;
+}
+
+export { type DirectProviderOptions, ModelCallOptions, type ProviderEmbeddingOptions, type ProviderGenerateOptions, ProviderModelClient, type ProviderStreamOptions };

package/dist/model/index.js

@@ -0,0 +1,16 @@
+import {
+  ModelClient,
+  ProviderModelClient,
+  managedModelProtocol,
+  modelBaseURL
+} from "../chunk-7Y263YIW.js";
+import "../chunk-K3TE7625.js";
+import "../chunk-NZL3VPJ2.js";
+import "../chunk-MZ5UWGXS.js";
+export {
+  ModelClient,
+  ProviderModelClient,
+  managedModelProtocol,
+  modelBaseURL
+};
+//# sourceMappingURL=index.js.map

package/dist/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/model-CkYHzHPk.d.cts

@@ -0,0 +1,50 @@
+type MessageRole = 'developer' | 'system' | 'user' | 'assistant' | 'tool' | 'activity' | 'reasoning';
+interface ToolCall {
+    id: string;
+    type: string;
+    function: Record<string, unknown>;
+}
+interface Message {
+    role: MessageRole;
+    content?: string | ReadonlyArray<Record<string, unknown>> | null;
+    id?: string;
+    name?: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+}
+interface AgentTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface AgentRequest {
+    protocol: string;
+    messages: Message[];
+    tools?: AgentTool[];
+    stream: boolean;
+    rawRequest: Request;
+    rawPayload: Record<string, unknown>;
+    /** Forward this signal to model/tool calls and any long-running application work. */
+    signal: AbortSignal;
+}
+declare const EventType: {
+    readonly TEXT: "TEXT";
+    readonly TEXT_END: "TEXT_END";
+    readonly REASONING: "REASONING";
+    readonly REASONING_END: "REASONING_END";
+    readonly TOOL_CALL: "TOOL_CALL";
+    readonly TOOL_CALL_CHUNK: "TOOL_CALL_CHUNK";
+    readonly TOOL_RESULT: "TOOL_RESULT";
+    readonly ERROR: "ERROR";
+};
+declare class AgentEvent {
+    readonly event: string;
+    readonly data: Record<string, unknown>;
+    constructor(event: string, data: Record<string, unknown>);
+    get type(): string;
+    toJSON(): Record<string, unknown>;
+}
+type AgentOutput = string | AgentEvent | undefined | null;
+type AgentResult = AgentOutput | Iterable<AgentOutput> | AsyncIterable<AgentOutput>;
+
+export { AgentEvent as A, EventType as E, type Message as M, type ToolCall as T, type AgentRequest as a, type AgentResult as b, type AgentOutput as c, type AgentTool as d, type MessageRole as e };

package/dist/model-CkYHzHPk.d.ts

@@ -0,0 +1,50 @@
+type MessageRole = 'developer' | 'system' | 'user' | 'assistant' | 'tool' | 'activity' | 'reasoning';
+interface ToolCall {
+    id: string;
+    type: string;
+    function: Record<string, unknown>;
+}
+interface Message {
+    role: MessageRole;
+    content?: string | ReadonlyArray<Record<string, unknown>> | null;
+    id?: string;
+    name?: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+}
+interface AgentTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface AgentRequest {
+    protocol: string;
+    messages: Message[];
+    tools?: AgentTool[];
+    stream: boolean;
+    rawRequest: Request;
+    rawPayload: Record<string, unknown>;
+    /** Forward this signal to model/tool calls and any long-running application work. */
+    signal: AbortSignal;
+}
+declare const EventType: {
+    readonly TEXT: "TEXT";
+    readonly TEXT_END: "TEXT_END";
+    readonly REASONING: "REASONING";
+    readonly REASONING_END: "REASONING_END";
+    readonly TOOL_CALL: "TOOL_CALL";
+    readonly TOOL_CALL_CHUNK: "TOOL_CALL_CHUNK";
+    readonly TOOL_RESULT: "TOOL_RESULT";
+    readonly ERROR: "ERROR";
+};
+declare class AgentEvent {
+    readonly event: string;
+    readonly data: Record<string, unknown>;
+    constructor(event: string, data: Record<string, unknown>);
+    get type(): string;
+    toJSON(): Record<string, unknown>;
+}
+type AgentOutput = string | AgentEvent | undefined | null;
+type AgentResult = AgentOutput | Iterable<AgentOutput> | AsyncIterable<AgentOutput>;
+
+export { AgentEvent as A, EventType as E, type Message as M, type ToolCall as T, type AgentRequest as a, type AgentResult as b, type AgentOutput as c, type AgentTool as d, type MessageRole as e };

package/dist/runtime/index.cjs

@@ -0,0 +1,49 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+var _chunkBVZ7H2F5cjs = require('../chunk-BVZ7H2F5.cjs');
+
+
+
+
+var _chunkULJTQSLEcjs = require('../chunk-ULJTQSLE.cjs');
+require('../chunk-YZP55W7S.cjs');
+require('../chunk-2E5EWEDG.cjs');
+
+
+
+
+
+
+
+
+var _chunk5RKN46UUcjs = require('../chunk-5RKN46UU.cjs');
+require('../chunk-LE5P3SJW.cjs');
+require('../chunk-JSP7ZROS.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.DEFAULT_CONFIG_PATH = _chunk5RKN46UUcjs.DEFAULT_CONFIG_PATH; exports.DEFAULT_ENV_PATH = _chunkBVZ7H2F5cjs.DEFAULT_ENV_PATH; exports.DebugRuntimeSource = _chunkBVZ7H2F5cjs.DebugRuntimeSource; exports.DebugToken = _chunkBVZ7H2F5cjs.DebugToken; exports.ManagedRuntimeSource = _chunkBVZ7H2F5cjs.ManagedRuntimeSource; exports.RequestContext = _chunkULJTQSLEcjs.RequestContext; exports.RuntimeEnvironmentProvider = _chunkBVZ7H2F5cjs.RuntimeEnvironmentProvider; exports.createRuntimeSource = _chunkBVZ7H2F5cjs.createRuntimeSource; exports.currentContext = _chunkULJTQSLEcjs.currentContext; exports.httpUrl = _chunk5RKN46UUcjs.httpUrl; exports.loadAgentConfig = _chunk5RKN46UUcjs.loadAgentConfig; exports.object = _chunk5RKN46UUcjs.object; exports.parseAgentConfig = _chunk5RKN46UUcjs.parseAgentConfig; exports.parseAgentConfigMapping = _chunk5RKN46UUcjs.parseAgentConfigMapping; exports.parseDebugToken = _chunkBVZ7H2F5cjs.parseDebugToken; exports.parseRuntimeEnvironment = _chunkBVZ7H2F5cjs.parseRuntimeEnvironment; exports.requiredString = _chunk5RKN46UUcjs.requiredString; exports.useContext = _chunkULJTQSLEcjs.useContext;
+//# sourceMappingURL=index.cjs.map

package/dist/runtime/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/zhuoguang/Documents/Code/collaborate/hiclaw/agentcore-sdk-nodejs/dist/runtime/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,umCAAC","file":"/Users/zhuoguang/Documents/Code/collaborate/hiclaw/agentcore-sdk-nodejs/dist/runtime/index.cjs"}

package/dist/runtime/index.d.cts

@@ -0,0 +1,73 @@
+export { A as AgentConfig, D as DEFAULT_CONFIG_PATH, h as httpUrl, l as loadAgentConfig, o as object, p as parseAgentConfig, a as parseAgentConfigMapping, r as requiredString } from '../config-CMkmMtx1.cjs';
+export { R as RequestContext, c as currentContext, u as useContext } from '../context-M9rOTifU.cjs';
+import { R as RuntimeSource, a as RuntimeBindings, M as ManagedRuntimeOptions } from '../managed-CwLx9h4C.cjs';
+export { b as ManagedRuntimeSource } from '../managed-CwLx9h4C.cjs';
+import { inspect } from 'node:util';
+import { C as ControllerOptions } from '../controller-DWs3Sy04.cjs';
+import { A as AgentSATokenSource } from '../agent-sa-token-DD1Sb8P1.cjs';
+import '../logging-C8GLLg1f.cjs';
+
+declare const DEFAULT_ENV_PATH = "/var/run/agentcore/agent/env";
+interface RuntimeEnvironment {
+    controllerUrl: string;
+    agentSATokenFile: string;
+    controlPlaneEndpoint?: string;
+}
+declare function parseRuntimeEnvironment(text: string): Record<string, string>;
+declare class RuntimeEnvironmentProvider {
+    readonly path: string;
+    constructor(path?: string);
+    read(): Promise<Record<string, string>>;
+    snapshot(): Promise<RuntimeEnvironment>;
+    value(name: string): Promise<string>;
+    taskServiceEndpoint(): Promise<string>;
+}
+
+declare class DebugToken {
+    #private;
+    readonly controllerUrl: string;
+    readonly modelGatewayUrl: string;
+    readonly matrixUrl: string;
+    readonly product = "agentcore";
+    constructor(jwtToken: string, controllerUrl: string, modelGatewayUrl: string, matrixUrl: string);
+    get jwtToken(): string;
+    [inspect.custom](): string;
+    toJSON(): string;
+}
+declare function parseDebugToken(value: string): DebugToken;
+interface DebugRuntimeOptions extends ControllerOptions {
+    controlPlaneEndpoint?: string;
+}
+declare class DebugRuntimeSource implements RuntimeSource, AgentSATokenSource {
+    #private;
+    private readonly token;
+    private readonly options;
+    private saExpiresAt;
+    private jwtExpiresAt;
+    private bindings?;
+    private resolving?;
+    private exchanging?;
+    private refreshTimer?;
+    private readonly lifetime;
+    private readonly configLoader;
+    private readonly controller;
+    private readonly logger;
+    constructor(token: DebugToken, options?: DebugRuntimeOptions);
+    get matrixUrl(): string;
+    resolve(): Promise<RuntimeBindings>;
+    get(): Promise<string>;
+    refresh(current: string): Promise<string>;
+    loadTeamsConfig(): Promise<Uint8Array | undefined>;
+    exchangeMatrixToken(): Promise<string>;
+    close(): void;
+    [inspect.custom](): string;
+    toJSON(): string;
+    private load;
+    private exchange;
+    private scheduleRefresh;
+    private backgroundRefresh;
+    private requestToken;
+}
+declare function createRuntimeSource(options?: ManagedRuntimeOptions): RuntimeSource;
+
+export { DEFAULT_ENV_PATH, type DebugRuntimeOptions, DebugRuntimeSource, DebugToken, ManagedRuntimeOptions, RuntimeBindings, type RuntimeEnvironment, RuntimeEnvironmentProvider, RuntimeSource, createRuntimeSource, parseDebugToken, parseRuntimeEnvironment };

package/dist/runtime/index.d.ts

@@ -0,0 +1,73 @@
+export { A as AgentConfig, D as DEFAULT_CONFIG_PATH, h as httpUrl, l as loadAgentConfig, o as object, p as parseAgentConfig, a as parseAgentConfigMapping, r as requiredString } from '../config-CMkmMtx1.js';
+export { R as RequestContext, c as currentContext, u as useContext } from '../context-M9rOTifU.js';
+import { R as RuntimeSource, a as RuntimeBindings, M as ManagedRuntimeOptions } from '../managed-D9eQK1ut.js';
+export { b as ManagedRuntimeSource } from '../managed-D9eQK1ut.js';
+import { inspect } from 'node:util';
+import { C as ControllerOptions } from '../controller-DmI4L4sP.js';
+import { A as AgentSATokenSource } from '../agent-sa-token-DD1Sb8P1.js';
+import '../logging-C8GLLg1f.js';
+
+declare const DEFAULT_ENV_PATH = "/var/run/agentcore/agent/env";
+interface RuntimeEnvironment {
+    controllerUrl: string;
+    agentSATokenFile: string;
+    controlPlaneEndpoint?: string;
+}
+declare function parseRuntimeEnvironment(text: string): Record<string, string>;
+declare class RuntimeEnvironmentProvider {
+    readonly path: string;
+    constructor(path?: string);
+    read(): Promise<Record<string, string>>;
+    snapshot(): Promise<RuntimeEnvironment>;
+    value(name: string): Promise<string>;
+    taskServiceEndpoint(): Promise<string>;
+}
+
+declare class DebugToken {
+    #private;
+    readonly controllerUrl: string;
+    readonly modelGatewayUrl: string;
+    readonly matrixUrl: string;
+    readonly product = "agentcore";
+    constructor(jwtToken: string, controllerUrl: string, modelGatewayUrl: string, matrixUrl: string);
+    get jwtToken(): string;
+    [inspect.custom](): string;
+    toJSON(): string;
+}
+declare function parseDebugToken(value: string): DebugToken;
+interface DebugRuntimeOptions extends ControllerOptions {
+    controlPlaneEndpoint?: string;
+}
+declare class DebugRuntimeSource implements RuntimeSource, AgentSATokenSource {
+    #private;
+    private readonly token;
+    private readonly options;
+    private saExpiresAt;
+    private jwtExpiresAt;
+    private bindings?;
+    private resolving?;
+    private exchanging?;
+    private refreshTimer?;
+    private readonly lifetime;
+    private readonly configLoader;
+    private readonly controller;
+    private readonly logger;
+    constructor(token: DebugToken, options?: DebugRuntimeOptions);
+    get matrixUrl(): string;
+    resolve(): Promise<RuntimeBindings>;
+    get(): Promise<string>;
+    refresh(current: string): Promise<string>;
+    loadTeamsConfig(): Promise<Uint8Array | undefined>;
+    exchangeMatrixToken(): Promise<string>;
+    close(): void;
+    [inspect.custom](): string;
+    toJSON(): string;
+    private load;
+    private exchange;
+    private scheduleRefresh;
+    private backgroundRefresh;
+    private requestToken;
+}
+declare function createRuntimeSource(options?: ManagedRuntimeOptions): RuntimeSource;
+
+export { DEFAULT_ENV_PATH, type DebugRuntimeOptions, DebugRuntimeSource, DebugToken, ManagedRuntimeOptions, RuntimeBindings, type RuntimeEnvironment, RuntimeEnvironmentProvider, RuntimeSource, createRuntimeSource, parseDebugToken, parseRuntimeEnvironment };

package/dist/runtime/index.js

@@ -0,0 +1,49 @@
+import {
+  DEFAULT_ENV_PATH,
+  DebugRuntimeSource,
+  DebugToken,
+  ManagedRuntimeSource,
+  RuntimeEnvironmentProvider,
+  createRuntimeSource,
+  parseDebugToken,
+  parseRuntimeEnvironment
+} from "../chunk-RHY7Y43E.js";
+import {
+  RequestContext,
+  currentContext,
+  useContext
+} from "../chunk-ZWQBAJ5O.js";
+import "../chunk-5JXA7JPS.js";
+import "../chunk-UBP5CHU7.js";
+import {
+  DEFAULT_CONFIG_PATH,
+  httpUrl,
+  loadAgentConfig,
+  object,
+  parseAgentConfig,
+  parseAgentConfigMapping,
+  requiredString
+} from "../chunk-K3TE7625.js";
+import "../chunk-NZL3VPJ2.js";
+import "../chunk-MZ5UWGXS.js";
+export {
+  DEFAULT_CONFIG_PATH,
+  DEFAULT_ENV_PATH,
+  DebugRuntimeSource,
+  DebugToken,
+  ManagedRuntimeSource,
+  RequestContext,
+  RuntimeEnvironmentProvider,
+  createRuntimeSource,
+  currentContext,
+  httpUrl,
+  loadAgentConfig,
+  object,
+  parseAgentConfig,
+  parseAgentConfigMapping,
+  parseDebugToken,
+  parseRuntimeEnvironment,
+  requiredString,
+  useContext
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}