@xiaozhiclaw/qlogicagent-core 0.6.0 → 0.6.2

package/dist/types/embedded/core-capabilities.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition } from "./contracts.js";
+export interface CoreCapabilities {
+    schemaVersion: 1;
+    packageName: "@xiaozhiclaw/qlogicagent-core";
+    packageVersion: string;
+    builtInTools: ToolDefinition[];
+}
+/** Describes this artifact only; product-injected tools are not core tools. */
+export declare function getCoreCapabilities(): CoreCapabilities;

package/dist/types/embedded/core-tools.d.ts

@@ -0,0 +1,101 @@
+import type { ToolDefinition, ToolResult } from "./contracts.js";
+import type { CloudToolInvocation, CloudToolWait } from "./cloud-agent.js";
+export interface CoreResourceRead {
+    resourceId: string;
+    version?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface CorePlanStep {
+    id: string;
+    description: string;
+    status: "pending" | "in_progress" | "completed" | "blocked" | "cancelled";
+    dependsOn?: string[];
+    evidenceRefs?: string[];
+}
+export interface CorePlanIssue {
+    id: string;
+    description: string;
+    stepIds?: string[];
+}
+export interface CorePlanSnapshot {
+    steps: CorePlanStep[];
+    issues: CorePlanIssue[];
+}
+export type CorePlanInput = {
+    action: "read";
+    planId: string;
+} | ({
+    action: "create";
+} & CorePlanSnapshot) | ({
+    action: "update";
+    planId: string;
+    expectedRevision: string;
+} & CorePlanSnapshot);
+export interface CoreConfirmationInput {
+    /** Immutable prepared-operation reference issued and resolved by the Host. */
+    operationRef: string;
+    summary: string;
+    targets: {
+        resourceId: string;
+        version?: string;
+    }[];
+    impacts: string[];
+}
+export interface CoreToolInputs {
+    qlogic_ask_user: {
+        question: string;
+        choices?: string[];
+    };
+    qlogic_discover_capabilities: {
+        cursor?: string;
+    };
+    qlogic_search_resources: {
+        query: string;
+        cursor?: string;
+        limit?: number;
+    };
+    qlogic_read_resource: CoreResourceRead;
+    qlogic_read_skill: {
+        skillId: string;
+        resourceId?: string;
+        version?: string;
+        cursor?: string;
+        limit?: number;
+    };
+    qlogic_update_plan: CorePlanInput;
+    qlogic_request_confirmation: CoreConfirmationInput;
+}
+export type CoreToolName = keyof CoreToolInputs;
+export type CoreToolWait<Name extends "qlogic_ask_user" | "qlogic_request_confirmation"> = {
+    kind: "wait";
+    wait: Omit<CloudToolWait["wait"], "kind"> & {
+        kind: Name extends "qlogic_ask_user" ? "input" : "confirmation";
+    };
+};
+export type CoreToolHandler<Name extends CoreToolName> = (input: Readonly<CoreToolInputs[Name]>, invocation: Readonly<CloudToolInvocation>, signal?: AbortSignal) => Promise<ToolResult | (Name extends "qlogic_ask_user" | "qlogic_request_confirmation" ? CoreToolWait<Name> : never)>;
+export interface CoreToolHost {
+    /** Revalidate the actor and exact resource/Skill reference on every invocation.
+     * A model-provided reference is never evidence of access or approval.
+     */
+    authorize(invocation: Readonly<CloudToolInvocation>, input: Readonly<CoreToolInputs[CoreToolName]>, signal?: AbortSignal): Promise<void>;
+    handlers: {
+        [Name in CoreToolName]?: CoreToolHandler<Name>;
+    };
+}
+export interface CoreToolAdapter {
+    /** Only explicitly mounted Host handlers are offered to the model. */
+    readonly definitions: ToolDefinition[];
+    handles(name: string): boolean;
+    invoke(invocation: CloudToolInvocation, signal?: AbortSignal): Promise<ToolResult | CloudToolWait>;
+}
+/** Artifact inventory, independent of any product's currently mounted handlers. */
+export declare function getCoreToolDefinitions(): ToolDefinition[];
+/** A typed dispatch adapter for the existing CloudAgent/CloudTask tool loop.
+ * The Host owns discovery, data, authorization, plans and user-decision receipts.
+ */
+export declare function createCoreToolAdapter(options: {
+    host: CoreToolHost;
+    /** Omit to enable the supplied handlers; an explicit list must have every handler. */
+    enabledTools?: readonly CoreToolName[];
+}): CoreToolAdapter;

package/dist/types/embedded/index.d.ts

@@ -1,6 +1,10 @@
 export { createEmbeddedAgent } from "./embedded-agent.js";
 export { prepareSlidingWindowContext } from "./context-projection.js";
 export { corePackageVersion } from "./package-version.js";
+export { getCoreCapabilities } from "./core-capabilities.js";
+export type { CoreCapabilities } from "./core-capabilities.js";
+export { createCoreToolAdapter } from "./core-tools.js";
+export type { CoreToolAdapter, CoreToolHost, CoreToolInputs, CoreToolName, CoreToolHandler, CoreToolWait, CoreResourceRead, CorePlanStep, CorePlanIssue, CorePlanSnapshot, CorePlanInput, CoreConfirmationInput } from "./core-tools.js";
 export { AgentContentBlockValidationError, parseAgentContentBlock, } from "./content-blocks.js";
 export type { ContextAnchor, ContextEnvelope, SemanticToolCapability, ToolIdentity, UsageRecord, UsageSource, AgentLogger, ChatMessage, CreateEmbeddedAgentOptions, EmbeddedAgent, EmbeddedRuntimeOptions, ModelContextPreparation, ModelContextProjection, LLMChunk, LLMRequest, LLMTransport, ModelRetryAuthorization, ToolDefinition, ToolInvoker, ToolInvocationContext, ToolResult, TurnCheckpoint, TokenUsage, TurnConfig, TurnEvent, TurnRequest, } from "./contracts.js";
 export type { ModelOperation, ModelRecoveryProof } from "./model-operation.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhiclaw/qlogicagent-core",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Shared SaaS Agent inference and durable task runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -15,13 +15,13 @@
     "dist/",
     "README.md"
   ],
+  "scripts": {
+    "build": "node scripts/build.mjs"
+  },
   "publishConfig": {
     "access": "public"
   },
   "engines": {
     "node": ">=24.0.0 <25"
-  },
-  "scripts": {
-    "build": "node scripts/build.mjs"
   }
-}
+}