@cognipeer/agent-sdk 0.10.3 → 0.10.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +240 -8
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +59 -2
- package/dist/index.d.ts +59 -2
- package/dist/index.mjs +236 -9
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ZodError, ZodSchema, z } from 'zod';
|
|
1
|
+
import { ZodError, ZodSchema, z, ZodTypeAny } from 'zod';
|
|
2
2
|
import { JSONSchema7 } from 'json-schema';
|
|
3
3
|
|
|
4
4
|
/** Describes what a model/provider natively supports. */
|
|
@@ -5167,6 +5167,13 @@ declare function resolveStrategy(model: any): StructuredOutputStrategy;
|
|
|
5167
5167
|
* - Auto-detection from model class name / metadata
|
|
5168
5168
|
*/
|
|
5169
5169
|
declare function getModelCapabilities(model: any): ModelCapabilities;
|
|
5170
|
+
/**
|
|
5171
|
+
* `ChatOpenAI` is also how OpenAI-COMPATIBLE servers (vLLM, Ollama, LM Studio,
|
|
5172
|
+
* gateways) are reached — with a custom `baseURL`. Strict tool mode is an
|
|
5173
|
+
* OpenAI/Azure feature, so only those hosts count; everything else gets the
|
|
5174
|
+
* plain schemas. No base URL means the SDK default, api.openai.com.
|
|
5175
|
+
*/
|
|
5176
|
+
declare function isOpenAIHostedEndpoint(lcModel: any): boolean;
|
|
5170
5177
|
|
|
5171
5178
|
declare function captureSnapshot(state: SmartState, options?: SnapshotOptions): AgentSnapshot;
|
|
5172
5179
|
declare function restoreSnapshot(snapshot: AgentSnapshot, restoreOptions?: RestoreSnapshotOptions): SmartState;
|
|
@@ -5367,6 +5374,56 @@ declare function validateToolArgs(tool: ToolInterface<any, any, any>, args: unkn
|
|
|
5367
5374
|
*/
|
|
5368
5375
|
declare function coerceToolArgs(schema: unknown, value: unknown): unknown;
|
|
5369
5376
|
|
|
5377
|
+
/**
|
|
5378
|
+
* Makes tool argument schemas acceptable to a provider's STRICT tool mode.
|
|
5379
|
+
*
|
|
5380
|
+
* OpenAI strict mode (`strict: true` on a function tool) has three rules that
|
|
5381
|
+
* ordinary tool schemas break:
|
|
5382
|
+
*
|
|
5383
|
+
* 1. every property must be listed in `required` — there are no optional
|
|
5384
|
+
* arguments, so a tool with an optional `offset` makes the provider reject
|
|
5385
|
+
* the WHOLE request (`400 Invalid schema for function … Missing 'offset'`);
|
|
5386
|
+
* 2. every object must be closed (`additionalProperties: false`), including
|
|
5387
|
+
* each branch of a union — `manage_plan`'s `todoList` union failed here;
|
|
5388
|
+
* 3. there is no free-form object — `body: { type: object }` with no
|
|
5389
|
+
* properties has no strict form at all.
|
|
5390
|
+
*
|
|
5391
|
+
* The transform keeps the tool's MEANING and changes only its wire form:
|
|
5392
|
+
*
|
|
5393
|
+
* - an optional argument becomes required-but-nullable (the model sends
|
|
5394
|
+
* `null` for "not given"), and `restore` drops those nulls again before the
|
|
5395
|
+
* tool runs — the executor sees exactly the arguments it always saw;
|
|
5396
|
+
* - objects (and union branches) are closed;
|
|
5397
|
+
* - a free-form object/record/any becomes a JSON-encoded STRING, which
|
|
5398
|
+
* `restore` parses back into the value the executor expects.
|
|
5399
|
+
*
|
|
5400
|
+
* `prepareStrictToolMenu` applies it at the one point every tool — the
|
|
5401
|
+
* caller's and the SDK's own (manage_plan, open_skill, spawn_subagent, …) —
|
|
5402
|
+
* passes through on its way to the provider, and `restoreToolCalls` maps the
|
|
5403
|
+
* model's strict-shaped arguments back before they are validated and run.
|
|
5404
|
+
*/
|
|
5405
|
+
|
|
5406
|
+
interface StrictTransform {
|
|
5407
|
+
schema: ZodTypeAny;
|
|
5408
|
+
/** Maps the model's strict-shaped arguments back to what the tool expects. */
|
|
5409
|
+
restore: (value: unknown) => unknown;
|
|
5410
|
+
}
|
|
5411
|
+
type StrictRestorers = Map<string, StrictTransform["restore"]>;
|
|
5412
|
+
declare function toStrictCompatible(schema: ZodTypeAny): StrictTransform;
|
|
5413
|
+
/** The strict transform of one tool's argument schema, top level included. */
|
|
5414
|
+
declare function toStrictToolSchema(schema: ZodTypeAny): StrictTransform;
|
|
5415
|
+
/**
|
|
5416
|
+
* Restores one model message's tool-call arguments to the tools' ORIGINAL
|
|
5417
|
+
* shape: the "not given" nulls dropped, JSON-encoded free-form values decoded.
|
|
5418
|
+
* Handles the SDK/LangChain form (`args` object), the raw OpenAI form
|
|
5419
|
+
* (`function.arguments` string) and `additional_kwargs.tool_calls`.
|
|
5420
|
+
*/
|
|
5421
|
+
declare function restoreToolCalls<M>(message: M, restorers: StrictRestorers): M;
|
|
5422
|
+
declare function prepareStrictToolMenu<T extends object>(tools: T[]): {
|
|
5423
|
+
menu: T[];
|
|
5424
|
+
restorers: StrictRestorers;
|
|
5425
|
+
};
|
|
5426
|
+
|
|
5370
5427
|
declare function fileSink(path?: string): TraceSinkConfig;
|
|
5371
5428
|
type CustomSinkArg = ((event: TraceEventRecord) => void | Promise<void>) | {
|
|
5372
5429
|
onEvent?: (event: TraceEventRecord) => void | Promise<void>;
|
|
@@ -5633,4 +5690,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
|
|
|
5633
5690
|
*/
|
|
5634
5691
|
declare function createProvider(config: ProviderConfig): BaseProvider;
|
|
5635
5692
|
|
|
5636
|
-
export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type ApprovalTransport, type AudioContent, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, type BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type ConversationPluginConfig, type ConversationStore, type CostEstimator, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, type FinalAnswerEvent, type FinishReason, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, type ImageContent, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, type OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, textFromContent, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
|
|
5693
|
+
export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type ApprovalTransport, type AudioContent, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, type BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type ConversationPluginConfig, type ConversationStore, type CostEstimator, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, type FinalAnswerEvent, type FinishReason, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, type ImageContent, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, type OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StrictRestorers, type StrictTransform, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, textFromContent, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ZodError, ZodSchema, z } from 'zod';
|
|
1
|
+
import { ZodError, ZodSchema, z, ZodTypeAny } from 'zod';
|
|
2
2
|
import { JSONSchema7 } from 'json-schema';
|
|
3
3
|
|
|
4
4
|
/** Describes what a model/provider natively supports. */
|
|
@@ -5167,6 +5167,13 @@ declare function resolveStrategy(model: any): StructuredOutputStrategy;
|
|
|
5167
5167
|
* - Auto-detection from model class name / metadata
|
|
5168
5168
|
*/
|
|
5169
5169
|
declare function getModelCapabilities(model: any): ModelCapabilities;
|
|
5170
|
+
/**
|
|
5171
|
+
* `ChatOpenAI` is also how OpenAI-COMPATIBLE servers (vLLM, Ollama, LM Studio,
|
|
5172
|
+
* gateways) are reached — with a custom `baseURL`. Strict tool mode is an
|
|
5173
|
+
* OpenAI/Azure feature, so only those hosts count; everything else gets the
|
|
5174
|
+
* plain schemas. No base URL means the SDK default, api.openai.com.
|
|
5175
|
+
*/
|
|
5176
|
+
declare function isOpenAIHostedEndpoint(lcModel: any): boolean;
|
|
5170
5177
|
|
|
5171
5178
|
declare function captureSnapshot(state: SmartState, options?: SnapshotOptions): AgentSnapshot;
|
|
5172
5179
|
declare function restoreSnapshot(snapshot: AgentSnapshot, restoreOptions?: RestoreSnapshotOptions): SmartState;
|
|
@@ -5367,6 +5374,56 @@ declare function validateToolArgs(tool: ToolInterface<any, any, any>, args: unkn
|
|
|
5367
5374
|
*/
|
|
5368
5375
|
declare function coerceToolArgs(schema: unknown, value: unknown): unknown;
|
|
5369
5376
|
|
|
5377
|
+
/**
|
|
5378
|
+
* Makes tool argument schemas acceptable to a provider's STRICT tool mode.
|
|
5379
|
+
*
|
|
5380
|
+
* OpenAI strict mode (`strict: true` on a function tool) has three rules that
|
|
5381
|
+
* ordinary tool schemas break:
|
|
5382
|
+
*
|
|
5383
|
+
* 1. every property must be listed in `required` — there are no optional
|
|
5384
|
+
* arguments, so a tool with an optional `offset` makes the provider reject
|
|
5385
|
+
* the WHOLE request (`400 Invalid schema for function … Missing 'offset'`);
|
|
5386
|
+
* 2. every object must be closed (`additionalProperties: false`), including
|
|
5387
|
+
* each branch of a union — `manage_plan`'s `todoList` union failed here;
|
|
5388
|
+
* 3. there is no free-form object — `body: { type: object }` with no
|
|
5389
|
+
* properties has no strict form at all.
|
|
5390
|
+
*
|
|
5391
|
+
* The transform keeps the tool's MEANING and changes only its wire form:
|
|
5392
|
+
*
|
|
5393
|
+
* - an optional argument becomes required-but-nullable (the model sends
|
|
5394
|
+
* `null` for "not given"), and `restore` drops those nulls again before the
|
|
5395
|
+
* tool runs — the executor sees exactly the arguments it always saw;
|
|
5396
|
+
* - objects (and union branches) are closed;
|
|
5397
|
+
* - a free-form object/record/any becomes a JSON-encoded STRING, which
|
|
5398
|
+
* `restore` parses back into the value the executor expects.
|
|
5399
|
+
*
|
|
5400
|
+
* `prepareStrictToolMenu` applies it at the one point every tool — the
|
|
5401
|
+
* caller's and the SDK's own (manage_plan, open_skill, spawn_subagent, …) —
|
|
5402
|
+
* passes through on its way to the provider, and `restoreToolCalls` maps the
|
|
5403
|
+
* model's strict-shaped arguments back before they are validated and run.
|
|
5404
|
+
*/
|
|
5405
|
+
|
|
5406
|
+
interface StrictTransform {
|
|
5407
|
+
schema: ZodTypeAny;
|
|
5408
|
+
/** Maps the model's strict-shaped arguments back to what the tool expects. */
|
|
5409
|
+
restore: (value: unknown) => unknown;
|
|
5410
|
+
}
|
|
5411
|
+
type StrictRestorers = Map<string, StrictTransform["restore"]>;
|
|
5412
|
+
declare function toStrictCompatible(schema: ZodTypeAny): StrictTransform;
|
|
5413
|
+
/** The strict transform of one tool's argument schema, top level included. */
|
|
5414
|
+
declare function toStrictToolSchema(schema: ZodTypeAny): StrictTransform;
|
|
5415
|
+
/**
|
|
5416
|
+
* Restores one model message's tool-call arguments to the tools' ORIGINAL
|
|
5417
|
+
* shape: the "not given" nulls dropped, JSON-encoded free-form values decoded.
|
|
5418
|
+
* Handles the SDK/LangChain form (`args` object), the raw OpenAI form
|
|
5419
|
+
* (`function.arguments` string) and `additional_kwargs.tool_calls`.
|
|
5420
|
+
*/
|
|
5421
|
+
declare function restoreToolCalls<M>(message: M, restorers: StrictRestorers): M;
|
|
5422
|
+
declare function prepareStrictToolMenu<T extends object>(tools: T[]): {
|
|
5423
|
+
menu: T[];
|
|
5424
|
+
restorers: StrictRestorers;
|
|
5425
|
+
};
|
|
5426
|
+
|
|
5370
5427
|
declare function fileSink(path?: string): TraceSinkConfig;
|
|
5371
5428
|
type CustomSinkArg = ((event: TraceEventRecord) => void | Promise<void>) | {
|
|
5372
5429
|
onEvent?: (event: TraceEventRecord) => void | Promise<void>;
|
|
@@ -5633,4 +5690,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
|
|
|
5633
5690
|
*/
|
|
5634
5691
|
declare function createProvider(config: ProviderConfig): BaseProvider;
|
|
5635
5692
|
|
|
5636
|
-
export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type ApprovalTransport, type AudioContent, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, type BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type ConversationPluginConfig, type ConversationStore, type CostEstimator, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, type FinalAnswerEvent, type FinishReason, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, type ImageContent, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, type OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, textFromContent, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
|
|
5693
|
+
export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type ApprovalTransport, type AudioContent, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, type BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type ConversationPluginConfig, type ConversationStore, type CostEstimator, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, type FinalAnswerEvent, type FinishReason, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, type ImageContent, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, type OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StrictRestorers, type StrictTransform, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, textFromContent, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
|
package/dist/index.mjs
CHANGED
|
@@ -503,7 +503,7 @@ function getModelCapabilities(model) {
|
|
|
503
503
|
return {
|
|
504
504
|
provider,
|
|
505
505
|
structuredOutput: supportsNativeStructuredOutput(provider) ? "native" : "tool_based",
|
|
506
|
-
strictToolCalling: requiresStrictToolCalling(provider),
|
|
506
|
+
strictToolCalling: requiresStrictToolCalling(provider) && isOpenAIHostedEndpoint(model._lc),
|
|
507
507
|
streaming: true
|
|
508
508
|
};
|
|
509
509
|
}
|
|
@@ -546,6 +546,17 @@ function supportsNativeStructuredOutput(provider) {
|
|
|
546
546
|
function requiresStrictToolCalling(provider) {
|
|
547
547
|
return ["openai"].includes(provider);
|
|
548
548
|
}
|
|
549
|
+
function isOpenAIHostedEndpoint(lcModel) {
|
|
550
|
+
if (!lcModel) return true;
|
|
551
|
+
const baseURL = lcModel.clientConfig?.baseURL ?? lcModel.configuration?.baseURL ?? lcModel.baseURL;
|
|
552
|
+
if (typeof baseURL !== "string" || baseURL.trim() === "") return true;
|
|
553
|
+
try {
|
|
554
|
+
const host = new URL(baseURL).hostname.toLowerCase();
|
|
555
|
+
return host === "api.openai.com" || host.endsWith(".openai.azure.com") || host.endsWith(".cognitiveservices.azure.com");
|
|
556
|
+
} catch {
|
|
557
|
+
return false;
|
|
558
|
+
}
|
|
559
|
+
}
|
|
549
560
|
|
|
550
561
|
// src/model.ts
|
|
551
562
|
function isSmartModel(m) {
|
|
@@ -2510,13 +2521,19 @@ function resolveCapabilities(provider) {
|
|
|
2510
2521
|
switch (provider) {
|
|
2511
2522
|
case "openai":
|
|
2512
2523
|
case "azure":
|
|
2513
|
-
case "openai-compatible":
|
|
2514
2524
|
return {
|
|
2515
2525
|
structuredOutput: "native",
|
|
2516
2526
|
strictToolCalling: true,
|
|
2517
2527
|
streaming: true,
|
|
2518
2528
|
provider
|
|
2519
2529
|
};
|
|
2530
|
+
case "openai-compatible":
|
|
2531
|
+
return {
|
|
2532
|
+
structuredOutput: "native",
|
|
2533
|
+
strictToolCalling: false,
|
|
2534
|
+
streaming: true,
|
|
2535
|
+
provider
|
|
2536
|
+
};
|
|
2520
2537
|
case "anthropic":
|
|
2521
2538
|
return {
|
|
2522
2539
|
structuredOutput: "tool_based",
|
|
@@ -3845,6 +3862,187 @@ Identical to an earlier ${duplicate.toolName} result. Use get_tool_response with
|
|
|
3845
3862
|
}
|
|
3846
3863
|
return notApplied4(output);
|
|
3847
3864
|
}
|
|
3865
|
+
var identity = (value) => value;
|
|
3866
|
+
function describeLike(schema, source, suffix) {
|
|
3867
|
+
const description = [source.description, suffix].filter(Boolean).join(" ");
|
|
3868
|
+
return description ? schema.describe(description) : schema;
|
|
3869
|
+
}
|
|
3870
|
+
function jsonString(source) {
|
|
3871
|
+
return {
|
|
3872
|
+
schema: describeLike(z.string(), source, "(a JSON value, encoded as a string)"),
|
|
3873
|
+
restore: (value) => {
|
|
3874
|
+
if (typeof value !== "string") return value;
|
|
3875
|
+
try {
|
|
3876
|
+
return JSON.parse(value);
|
|
3877
|
+
} catch {
|
|
3878
|
+
return value;
|
|
3879
|
+
}
|
|
3880
|
+
}
|
|
3881
|
+
};
|
|
3882
|
+
}
|
|
3883
|
+
function unwrapOptional(schema) {
|
|
3884
|
+
const def = schema._def;
|
|
3885
|
+
if (def?.typeName === "ZodOptional") return { inner: def.innerType, optional: true };
|
|
3886
|
+
if (def?.typeName === "ZodDefault") return { inner: def.innerType, optional: true };
|
|
3887
|
+
return { inner: schema, optional: false };
|
|
3888
|
+
}
|
|
3889
|
+
function isZodSchema2(schema) {
|
|
3890
|
+
return Boolean(schema) && typeof schema.safeParse === "function" && Boolean(schema._def);
|
|
3891
|
+
}
|
|
3892
|
+
function toStrictCompatible(schema) {
|
|
3893
|
+
const def = schema?._def;
|
|
3894
|
+
switch (def?.typeName) {
|
|
3895
|
+
case "ZodObject": {
|
|
3896
|
+
const shape = typeof def.shape === "function" ? def.shape() : def.shape;
|
|
3897
|
+
const keys = Object.keys(shape ?? {});
|
|
3898
|
+
const open = def.unknownKeys === "passthrough" || def.catchall && def.catchall._def?.typeName !== "ZodNever";
|
|
3899
|
+
if (keys.length === 0 && open) return jsonString(schema);
|
|
3900
|
+
const nextShape = {};
|
|
3901
|
+
const restores = {};
|
|
3902
|
+
for (const key of keys) {
|
|
3903
|
+
const field = shape[key];
|
|
3904
|
+
const { inner, optional } = unwrapOptional(field);
|
|
3905
|
+
const child = toStrictCompatible(inner);
|
|
3906
|
+
const childSchema = describeLike(child.schema, field.description ? field : inner);
|
|
3907
|
+
nextShape[key] = optional ? childSchema.nullable() : childSchema;
|
|
3908
|
+
restores[key] = { restore: child.restore, optional };
|
|
3909
|
+
}
|
|
3910
|
+
return {
|
|
3911
|
+
schema: describeLike(z.object(nextShape), schema),
|
|
3912
|
+
restore: (value) => {
|
|
3913
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) return value;
|
|
3914
|
+
const out = {};
|
|
3915
|
+
for (const [key, raw] of Object.entries(value)) {
|
|
3916
|
+
const entry = restores[key];
|
|
3917
|
+
if (raw === null && entry?.optional) continue;
|
|
3918
|
+
out[key] = entry ? entry.restore(raw) : raw;
|
|
3919
|
+
}
|
|
3920
|
+
return out;
|
|
3921
|
+
}
|
|
3922
|
+
};
|
|
3923
|
+
}
|
|
3924
|
+
case "ZodOptional":
|
|
3925
|
+
case "ZodDefault": {
|
|
3926
|
+
const child = toStrictCompatible(def.innerType);
|
|
3927
|
+
return {
|
|
3928
|
+
schema: describeLike(child.schema.nullable(), schema),
|
|
3929
|
+
restore: (value) => value === null ? void 0 : child.restore(value)
|
|
3930
|
+
};
|
|
3931
|
+
}
|
|
3932
|
+
case "ZodNullable": {
|
|
3933
|
+
const child = toStrictCompatible(def.innerType);
|
|
3934
|
+
return {
|
|
3935
|
+
schema: describeLike(child.schema.nullable(), schema),
|
|
3936
|
+
restore: (value) => value === null ? null : child.restore(value)
|
|
3937
|
+
};
|
|
3938
|
+
}
|
|
3939
|
+
case "ZodArray": {
|
|
3940
|
+
const child = toStrictCompatible(def.type);
|
|
3941
|
+
return {
|
|
3942
|
+
schema: describeLike(z.array(child.schema), schema),
|
|
3943
|
+
restore: (value) => Array.isArray(value) ? value.map(child.restore) : value
|
|
3944
|
+
};
|
|
3945
|
+
}
|
|
3946
|
+
case "ZodUnion":
|
|
3947
|
+
case "ZodDiscriminatedUnion": {
|
|
3948
|
+
const rawOptions = def.options instanceof Map ? [...def.options.values()] : def.options;
|
|
3949
|
+
const options = rawOptions.map(toStrictCompatible);
|
|
3950
|
+
if (options.length === 1) return options[0];
|
|
3951
|
+
if (options.every((option, index) => option.schema === rawOptions[index])) {
|
|
3952
|
+
return { schema, restore: identity };
|
|
3953
|
+
}
|
|
3954
|
+
return {
|
|
3955
|
+
schema: describeLike(z.union(options.map((option) => option.schema)), schema),
|
|
3956
|
+
restore: (value) => {
|
|
3957
|
+
const candidates = options.map((option) => option.restore(value));
|
|
3958
|
+
const index = candidates.findIndex((candidate, i) => rawOptions[i].safeParse(candidate).success);
|
|
3959
|
+
return candidates[index >= 0 ? index : 0];
|
|
3960
|
+
}
|
|
3961
|
+
};
|
|
3962
|
+
}
|
|
3963
|
+
case "ZodEffects":
|
|
3964
|
+
return toStrictCompatible(def.schema);
|
|
3965
|
+
case "ZodRecord":
|
|
3966
|
+
case "ZodAny":
|
|
3967
|
+
case "ZodUnknown":
|
|
3968
|
+
return jsonString(schema);
|
|
3969
|
+
default:
|
|
3970
|
+
return { schema, restore: identity };
|
|
3971
|
+
}
|
|
3972
|
+
}
|
|
3973
|
+
function topLevelObject(transform) {
|
|
3974
|
+
if (transform.schema._def?.typeName === "ZodObject") return transform;
|
|
3975
|
+
return {
|
|
3976
|
+
schema: z.object({
|
|
3977
|
+
input: transform.schema.describe(
|
|
3978
|
+
transform.schema.description ?? "The tool arguments as a JSON object, encoded as a string"
|
|
3979
|
+
)
|
|
3980
|
+
}),
|
|
3981
|
+
restore: (value) => {
|
|
3982
|
+
const input = value && typeof value === "object" ? value.input : void 0;
|
|
3983
|
+
const restored = transform.restore(input);
|
|
3984
|
+
return restored && typeof restored === "object" ? restored : {};
|
|
3985
|
+
}
|
|
3986
|
+
};
|
|
3987
|
+
}
|
|
3988
|
+
function toStrictToolSchema(schema) {
|
|
3989
|
+
return topLevelObject(toStrictCompatible(schema));
|
|
3990
|
+
}
|
|
3991
|
+
function restoreToolCalls(message, restorers) {
|
|
3992
|
+
if (!message || typeof message !== "object" || restorers.size === 0) return message;
|
|
3993
|
+
const restoreList = (calls) => {
|
|
3994
|
+
if (!Array.isArray(calls) || calls.length === 0) return calls;
|
|
3995
|
+
return calls.map((call) => {
|
|
3996
|
+
const fn = call?.function;
|
|
3997
|
+
const name = call?.name ?? fn?.name;
|
|
3998
|
+
const restore = name ? restorers.get(name) : void 0;
|
|
3999
|
+
if (!restore) return call;
|
|
4000
|
+
let next = call;
|
|
4001
|
+
if (call.args && typeof call.args === "object") next = { ...next, args: restore(call.args) };
|
|
4002
|
+
if (fn && typeof fn.arguments === "string") {
|
|
4003
|
+
try {
|
|
4004
|
+
next = { ...next, function: { ...fn, arguments: JSON.stringify(restore(JSON.parse(fn.arguments))) } };
|
|
4005
|
+
} catch {
|
|
4006
|
+
}
|
|
4007
|
+
}
|
|
4008
|
+
return next;
|
|
4009
|
+
});
|
|
4010
|
+
};
|
|
4011
|
+
const m = message;
|
|
4012
|
+
const hasDirect = Array.isArray(m.tool_calls) && m.tool_calls.length > 0;
|
|
4013
|
+
const hasKwargs = Array.isArray(m.additional_kwargs?.tool_calls) && m.additional_kwargs.tool_calls.length > 0;
|
|
4014
|
+
if (!hasDirect && !hasKwargs) return message;
|
|
4015
|
+
return {
|
|
4016
|
+
...message,
|
|
4017
|
+
...hasDirect ? { tool_calls: restoreList(m.tool_calls) } : {},
|
|
4018
|
+
...hasKwargs ? { additional_kwargs: { ...m.additional_kwargs, tool_calls: restoreList(m.additional_kwargs.tool_calls) } } : {}
|
|
4019
|
+
};
|
|
4020
|
+
}
|
|
4021
|
+
var strictViews = /* @__PURE__ */ new WeakMap();
|
|
4022
|
+
function prepareStrictToolMenu(tools) {
|
|
4023
|
+
const restorers = /* @__PURE__ */ new Map();
|
|
4024
|
+
const menu = tools.map((tool) => {
|
|
4025
|
+
const t = tool;
|
|
4026
|
+
if (!t || typeof t.name !== "string" || !isZodSchema2(t.schema)) return tool;
|
|
4027
|
+
const cached = strictViews.get(tool);
|
|
4028
|
+
if (cached && cached.schema === t.schema) {
|
|
4029
|
+
restorers.set(t.name, cached.restore);
|
|
4030
|
+
return cached.view;
|
|
4031
|
+
}
|
|
4032
|
+
try {
|
|
4033
|
+
const transform = toStrictToolSchema(t.schema);
|
|
4034
|
+
const view = Object.create(tool);
|
|
4035
|
+
view.schema = transform.schema;
|
|
4036
|
+
view.__lcTool = void 0;
|
|
4037
|
+
strictViews.set(tool, { schema: t.schema, view, restore: transform.restore });
|
|
4038
|
+
restorers.set(t.name, transform.restore);
|
|
4039
|
+
return view;
|
|
4040
|
+
} catch {
|
|
4041
|
+
return tool;
|
|
4042
|
+
}
|
|
4043
|
+
});
|
|
4044
|
+
return { menu, restorers };
|
|
4045
|
+
}
|
|
3848
4046
|
|
|
3849
4047
|
// src/nodes/agentCore.ts
|
|
3850
4048
|
function createAgentCoreNode(opts) {
|
|
@@ -3865,10 +4063,17 @@ function createAgentCoreNode(opts) {
|
|
|
3865
4063
|
};
|
|
3866
4064
|
let tools = runtime.tools ?? [];
|
|
3867
4065
|
const shouldUseStrictToolCalling = Boolean(
|
|
3868
|
-
runtime.
|
|
4066
|
+
runtime.model?.capabilities?.strictToolCalling
|
|
3869
4067
|
);
|
|
4068
|
+
let strictRestorers = /* @__PURE__ */ new Map();
|
|
4069
|
+
const wireMenu = (menu) => {
|
|
4070
|
+
if (!shouldUseStrictToolCalling) return menu;
|
|
4071
|
+
const prepared = prepareStrictToolMenu(menu);
|
|
4072
|
+
strictRestorers = prepared.restorers;
|
|
4073
|
+
return prepared.menu;
|
|
4074
|
+
};
|
|
3870
4075
|
const bindToolMenu = (menu) => runtime.model?.bindTools ? runtime.model.bindTools(
|
|
3871
|
-
menu,
|
|
4076
|
+
wireMenu(menu),
|
|
3872
4077
|
shouldUseStrictToolCalling ? { strict: true } : void 0
|
|
3873
4078
|
) : runtime.model;
|
|
3874
4079
|
const menuMutationReachesProvider = typeof runtime.model?.bindTools === "function";
|
|
@@ -3879,7 +4084,8 @@ function createAgentCoreNode(opts) {
|
|
|
3879
4084
|
const computeTraceToolDefinitions = (menu) => {
|
|
3880
4085
|
if (!traceSession || !traceSession.resolvedConfig.logData || menu.length === 0) return void 0;
|
|
3881
4086
|
try {
|
|
3882
|
-
|
|
4087
|
+
const wire = shouldUseStrictToolCalling ? prepareStrictToolMenu(menu).menu : menu;
|
|
4088
|
+
return wire.map((tool) => {
|
|
3883
4089
|
const def = toToolDefinition(tool, shouldUseStrictToolCalling ? true : void 0);
|
|
3884
4090
|
return { name: def.name, description: def.description || void 0, parameters: def.parameters };
|
|
3885
4091
|
});
|
|
@@ -4185,6 +4391,9 @@ ${append}`;
|
|
|
4185
4391
|
throw err;
|
|
4186
4392
|
}
|
|
4187
4393
|
}
|
|
4394
|
+
if (shortCircuited === void 0 && strictRestorers.size > 0) {
|
|
4395
|
+
response = restoreToolCalls(response, strictRestorers);
|
|
4396
|
+
}
|
|
4188
4397
|
if (!host?.has("postModelCall")) break;
|
|
4189
4398
|
const postGate = await host.runGate("postModelCall", {
|
|
4190
4399
|
message: response,
|
|
@@ -8783,6 +8992,21 @@ var todoUpdateItemSchema = z.object({
|
|
|
8783
8992
|
status: todoStatusSchema.optional(),
|
|
8784
8993
|
evidence: z.string().max(300).optional()
|
|
8785
8994
|
});
|
|
8995
|
+
var todoItemWireSchema = z.object({
|
|
8996
|
+
id: z.number().int().min(1).describe("Sequential id starting from 1 (write) or an existing id (update)"),
|
|
8997
|
+
step: z.string().min(1).optional(),
|
|
8998
|
+
title: z.string().min(1).optional(),
|
|
8999
|
+
description: z.string().min(1).optional(),
|
|
9000
|
+
owner: z.string().min(1).optional(),
|
|
9001
|
+
exitCriteria: z.string().min(1).optional(),
|
|
9002
|
+
status: todoStatusSchema.optional().describe("Required for every item on write"),
|
|
9003
|
+
evidence: z.string().max(300).optional()
|
|
9004
|
+
});
|
|
9005
|
+
function describeTodoIssue(issue) {
|
|
9006
|
+
if (!issue) return void 0;
|
|
9007
|
+
const path2 = issue.path.length > 0 ? `todoList[${issue.path[0]}]${issue.path.slice(1).map((p) => `.${String(p)}`).join("")}` : "todoList";
|
|
9008
|
+
return `${path2}: ${issue.message}`;
|
|
9009
|
+
}
|
|
8786
9010
|
function normalizeTodoItem(item, existing) {
|
|
8787
9011
|
const id = item.id ?? existing?.id;
|
|
8788
9012
|
const step = item.step || item.title || item.description || existing?.step || existing?.title || existing?.description || `Step ${id}`;
|
|
@@ -8899,7 +9123,7 @@ function createPlanTool(stateRef, toolName, description) {
|
|
|
8899
9123
|
schema: z.object({
|
|
8900
9124
|
operation: z.enum(["write", "read", "update"]),
|
|
8901
9125
|
expectedVersion: z.number().int().min(0).optional(),
|
|
8902
|
-
todoList: z.array(
|
|
9126
|
+
todoList: z.array(todoItemWireSchema).optional()
|
|
8903
9127
|
}),
|
|
8904
9128
|
func: async ({ operation, expectedVersion, todoList }) => {
|
|
8905
9129
|
const toolStateRef = manageTodo._stateRef;
|
|
@@ -8965,7 +9189,10 @@ function createPlanTool(stateRef, toolName, description) {
|
|
|
8965
9189
|
return {
|
|
8966
9190
|
status: "error",
|
|
8967
9191
|
operation,
|
|
8968
|
-
|
|
9192
|
+
// The wire schema has `status` optional (one shape for write and
|
|
9193
|
+
// update), so a missing one is caught here — named, so the model
|
|
9194
|
+
// can fix the call.
|
|
9195
|
+
error: describeTodoIssue(parsed.error.issues[0]) || "Invalid todoList for write.",
|
|
8969
9196
|
version: currentVersion,
|
|
8970
9197
|
adherenceScore: stateRef.adherenceScore || 0
|
|
8971
9198
|
};
|
|
@@ -8988,7 +9215,7 @@ function createPlanTool(stateRef, toolName, description) {
|
|
|
8988
9215
|
return {
|
|
8989
9216
|
status: "error",
|
|
8990
9217
|
operation,
|
|
8991
|
-
error: parsed.error.issues[0]
|
|
9218
|
+
error: describeTodoIssue(parsed.error.issues[0]) || "Invalid todoList for update.",
|
|
8992
9219
|
version: currentVersion,
|
|
8993
9220
|
adherenceScore: stateRef.adherenceScore || 0
|
|
8994
9221
|
};
|
|
@@ -16517,6 +16744,6 @@ function createProvider(config) {
|
|
|
16517
16744
|
}
|
|
16518
16745
|
}
|
|
16519
16746
|
|
|
16520
|
-
export { ASK_USER_TOOL_NAME, AnthropicProvider, AzureProvider, BaseProvider, BedrockProvider, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, GuardrailPhase, HOOK_CONTRACT_VERSION, HOOK_NAMES, HookTimeoutError, InMemoryMemoryStore, NativeJsonSchemaStrategy, OpenAICompatibleProvider, OpenAIProvider, PREOPEN_TOOL_CALL_PREFIX, ProviderError, SMALL_TIER_SKILL_POLICY, StructuredOutputManager, TOOL_INPUT_DIGEST_KEY, ToolBasedStrategy, VertexProvider, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText2 as extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, textFromContent, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
|
|
16747
|
+
export { ASK_USER_TOOL_NAME, AnthropicProvider, AzureProvider, BaseProvider, BedrockProvider, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, GuardrailPhase, HOOK_CONTRACT_VERSION, HOOK_NAMES, HookTimeoutError, InMemoryMemoryStore, NativeJsonSchemaStrategy, OpenAICompatibleProvider, OpenAIProvider, PREOPEN_TOOL_CALL_PREFIX, ProviderError, SMALL_TIER_SKILL_POLICY, StructuredOutputManager, TOOL_INPUT_DIGEST_KEY, ToolBasedStrategy, VertexProvider, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText2 as extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, textFromContent, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
|
|
16521
16748
|
//# sourceMappingURL=index.mjs.map
|
|
16522
16749
|
//# sourceMappingURL=index.mjs.map
|