@anchrd/intel-contract 0.1.0 → 0.2.0

package/README.md

@@ -1,11 +1,32 @@
 # @anchrd/intel-contract
 
-Runtime-validated wire schemas for Intel's HTTP, MCP, and browser surfaces.
+The shared wire contract for [`@anchrd/intel-api`](https://www.npmjs.com/package/@anchrd/intel-api): Zod
+schemas that describe every payload crossing Intel's HTTP, MCP and browser surfaces.
+
+You rarely install this directly — the server and the UI both depend on it. Reach for it when you
+write your own client against the Intel HTTP API and want the same types and validation the server
+uses.
+
+## Install
+
+```bash
+npm install @anchrd/intel-contract
+```
+
+## Use
 
 ```ts
-import { CreateKnowledgeNodeInput } from "@anchrd/intel-contract";
+import { CreateKnowledgeNodeInput, KnowledgeNode } from "@anchrd/intel-contract";
 
 const input = CreateKnowledgeNodeInput.parse(payload);
+const node = KnowledgeNode.parse(await response.json());
 ```
 
-Mutation inputs are strict: unknown fields are rejected instead of silently ignored.
+Mutation inputs are strict: an unknown field is rejected rather than silently dropped, so a typo in
+a client never becomes a value that quietly fails to apply. Types are inferred from the schemas, so
+`z.infer` gives you the same shape the server validates against.
+
+## License
+
+Proprietary. Published publicly for installation convenience; this is not an open-source license and
+grants no right to use, copy, modify or redistribute the software. Contact Anchrd for licensing.

package/dist/contract/contract.d.ts

@@ -483,18 +483,7 @@ export declare const DeleteKnowledgeLinkResult: z.ZodObject<{
 }, z.core.$strict>;
 export type DeleteKnowledgeLinkResult = z.infer<typeof DeleteKnowledgeLinkResult>;
 export declare const ToolSourceUrl: z.ZodURL;
-export declare const ToolSource: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    url: z.ZodURL;
-    connectionHandle: z.ZodString;
-    enabled: z.ZodBoolean;
-    createdBy: z.ZodString;
-    createdAt: z.ZodISODateTime;
-    updatedAt: z.ZodISODateTime;
-    lastDiscoveredAt: z.ZodNullable<z.ZodISODateTime>;
-}, z.core.$strict>;
-export type ToolSource = z.infer<typeof ToolSource>;
+export declare const ToolName: z.ZodString;
 export declare const ToolAnnotations: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     readOnlyHint: z.ZodOptional<z.ZodBoolean>;
@@ -504,7 +493,6 @@ export declare const ToolAnnotations: z.ZodObject<{
 }, z.core.$strict>;
 export type ToolAnnotations = z.infer<typeof ToolAnnotations>;
 export declare const ToolCapability: z.ZodObject<{
-    sourceId: z.ZodString;
     name: z.ZodString;
     title: z.ZodNullable<z.ZodString>;
     description: z.ZodNullable<z.ZodString>;
@@ -518,30 +506,11 @@ export declare const ToolCapability: z.ZodObject<{
         openWorldHint: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>;
     fingerprint: z.ZodString;
-    discoveredAt: z.ZodISODateTime;
 }, z.core.$strict>;
 export type ToolCapability = z.infer<typeof ToolCapability>;
-export declare const ToolConnectionStatus: z.ZodEnum<{
-    connected: "connected";
-    missing: "missing";
-    forbidden: "forbidden";
-    invalid: "invalid";
-}>;
-export type ToolConnectionStatus = z.infer<typeof ToolConnectionStatus>;
-export declare const ToolCatalogEntry: z.ZodObject<{
-    source: z.ZodObject<{
-        id: z.ZodString;
-        name: z.ZodString;
-        url: z.ZodURL;
-        connectionHandle: z.ZodString;
-        enabled: z.ZodBoolean;
-        createdBy: z.ZodString;
-        createdAt: z.ZodISODateTime;
-        updatedAt: z.ZodISODateTime;
-        lastDiscoveredAt: z.ZodNullable<z.ZodISODateTime>;
-    }, z.core.$strict>;
-    capability: z.ZodObject<{
-        sourceId: z.ZodString;
+export declare const ToolCatalog: z.ZodObject<{
+    portalConnected: z.ZodBoolean;
+    items: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         title: z.ZodNullable<z.ZodString>;
         description: z.ZodNullable<z.ZodString>;
@@ -555,89 +524,15 @@ export declare const ToolCatalogEntry: z.ZodObject<{
             openWorldHint: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>;
         fingerprint: z.ZodString;
-        discoveredAt: z.ZodISODateTime;
-    }, z.core.$strict>;
-    connectionStatus: z.ZodEnum<{
-        connected: "connected";
-        missing: "missing";
-        forbidden: "forbidden";
-        invalid: "invalid";
-    }>;
-}, z.core.$strict>;
-export type ToolCatalogEntry = z.infer<typeof ToolCatalogEntry>;
-export declare const ToolSourceList: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        name: z.ZodString;
-        url: z.ZodURL;
-        connectionHandle: z.ZodString;
-        enabled: z.ZodBoolean;
-        createdBy: z.ZodString;
-        createdAt: z.ZodISODateTime;
-        updatedAt: z.ZodISODateTime;
-        lastDiscoveredAt: z.ZodNullable<z.ZodISODateTime>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type ToolSourceList = z.infer<typeof ToolSourceList>;
-export declare const ToolCatalog: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
-        source: z.ZodObject<{
-            id: z.ZodString;
-            name: z.ZodString;
-            url: z.ZodURL;
-            connectionHandle: z.ZodString;
-            enabled: z.ZodBoolean;
-            createdBy: z.ZodString;
-            createdAt: z.ZodISODateTime;
-            updatedAt: z.ZodISODateTime;
-            lastDiscoveredAt: z.ZodNullable<z.ZodISODateTime>;
-        }, z.core.$strict>;
-        capability: z.ZodObject<{
-            sourceId: z.ZodString;
-            name: z.ZodString;
-            title: z.ZodNullable<z.ZodString>;
-            description: z.ZodNullable<z.ZodString>;
-            inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-            outputSchema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            annotations: z.ZodObject<{
-                title: z.ZodOptional<z.ZodString>;
-                readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-                destructiveHint: z.ZodOptional<z.ZodBoolean>;
-                idempotentHint: z.ZodOptional<z.ZodBoolean>;
-                openWorldHint: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strict>;
-            fingerprint: z.ZodString;
-            discoveredAt: z.ZodISODateTime;
-        }, z.core.$strict>;
-        connectionStatus: z.ZodEnum<{
-            connected: "connected";
-            missing: "missing";
-            forbidden: "forbidden";
-            invalid: "invalid";
-        }>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type ToolCatalog = z.infer<typeof ToolCatalog>;
-export declare const CreateToolSourceInput: z.ZodObject<{
-    name: z.ZodString;
-    url: z.ZodURL;
-    connectionHandle: z.ZodDefault<z.ZodString>;
-    idempotencyKey: z.ZodString;
-}, z.core.$strict>;
-export type CreateToolSourceInput = z.infer<typeof CreateToolSourceInput>;
-export declare const DiscoverToolSourceInput: z.ZodObject<{
-    sourceId: z.ZodString;
-    idempotencyKey: z.ZodString;
-}, z.core.$strict>;
-export type DiscoverToolSourceInput = z.infer<typeof DiscoverToolSourceInput>;
 export declare const TestToolInput: z.ZodObject<{
-    sourceId: z.ZodString;
     name: z.ZodString;
     arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 export type TestToolInput = z.infer<typeof TestToolInput>;
 export declare const ExecuteToolInput: z.ZodObject<{
-    sourceId: z.ZodString;
     name: z.ZodString;
     arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
@@ -703,7 +598,6 @@ export declare const FlowNode: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"tool">;
     configuration: z.ZodObject<{
-        sourceId: z.ZodString;
         toolName: z.ZodString;
         fingerprint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -814,7 +708,6 @@ export declare const FlowGraph: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"tool">;
         configuration: z.ZodObject<{
-            sourceId: z.ZodString;
             toolName: z.ZodString;
             fingerprint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -941,7 +834,6 @@ export declare const FlowVersion: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"tool">;
             configuration: z.ZodObject<{
-                sourceId: z.ZodString;
                 toolName: z.ZodString;
                 fingerprint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1071,7 +963,6 @@ export declare const FlowDocument: z.ZodObject<{
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"tool">;
                 configuration: z.ZodObject<{
-                    sourceId: z.ZodString;
                     toolName: z.ZodString;
                     fingerprint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                     arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1213,7 +1104,6 @@ export declare const SaveFlowVersionInput: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"tool">;
             configuration: z.ZodObject<{
-                sourceId: z.ZodString;
                 toolName: z.ZodString;
                 fingerprint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1415,7 +1305,6 @@ export declare const FlowRunStep: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"tool">;
         configuration: z.ZodObject<{
-            sourceId: z.ZodString;
             toolName: z.ZodString;
             fingerprint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/contract/contract.js

@@ -227,18 +227,10 @@ export const ToolSourceUrl = z.url().refine((value) => {
     catch {
         return false;
     }
-}, "Tool source must use an approved public HTTPS host without embedded credentials");
-export const ToolSource = z.strictObject({
-    id: IntelId,
-    name: z.string().min(1).max(120),
-    url: ToolSourceUrl,
-    connectionHandle: z.string().regex(/^[a-z0-9][a-z0-9-]{1,62}$/),
-    enabled: z.boolean(),
-    createdBy: IntelId,
-    createdAt: IsoDateTime,
-    updatedAt: IsoDateTime,
-    lastDiscoveredAt: IsoDateTime.nullable(),
-});
+}, "The portal must use an approved public HTTPS host without embedded credentials");
+// The portal namespaces every upstream tool, so the name alone identifies the target server. Intel
+// never learns which server that is — the portal resolves it and attaches the credentials.
+export const ToolName = z.string().min(1).max(240);
 export const ToolAnnotations = z.strictObject({
     title: z.string().max(240).optional(),
     readOnlyHint: z.boolean().optional(),
@@ -247,40 +239,22 @@ export const ToolAnnotations = z.strictObject({
     openWorldHint: z.boolean().optional(),
 });
 export const ToolCapability = z.strictObject({
-    sourceId: IntelId,
-    name: z.string().min(1).max(240),
+    name: ToolName,
     title: z.string().max(240).nullable(),
     description: z.string().max(10_000).nullable(),
     inputSchema: z.record(z.string(), z.unknown()),
     outputSchema: z.record(z.string(), z.unknown()).nullable(),
     annotations: ToolAnnotations,
     fingerprint: z.string().regex(/^[a-f0-9]{64}$/),
-    discoveredAt: IsoDateTime,
-});
-export const ToolConnectionStatus = z.enum(["connected", "missing", "forbidden", "invalid"]);
-export const ToolCatalogEntry = z.strictObject({
-    source: ToolSource,
-    capability: ToolCapability,
-    connectionStatus: ToolConnectionStatus,
-});
-export const ToolSourceList = z.strictObject({ items: z.array(ToolSource) });
-export const ToolCatalog = z.strictObject({ items: z.array(ToolCatalogEntry) });
-export const CreateToolSourceInput = z.strictObject({
-    name: z.string().trim().min(1).max(120),
-    url: ToolSourceUrl,
-    connectionHandle: z
-        .string()
-        .regex(/^[a-z0-9][a-z0-9-]{1,62}$/)
-        .default("intel-tools"),
-    idempotencyKey: z.string().min(8).max(200),
 });
-export const DiscoverToolSourceInput = z.strictObject({
-    sourceId: IntelId,
-    idempotencyKey: z.string().min(8).max(200),
+// The catalog reflects one live tools/list for the requesting user. It is never stored as a
+// permission mirror, so there is no per-source state and no Intel-owned connection status.
+export const ToolCatalog = z.strictObject({
+    portalConnected: z.boolean(),
+    items: z.array(ToolCapability),
 });
 export const TestToolInput = z.strictObject({
-    sourceId: IntelId,
-    name: z.string().min(1).max(240),
+    name: ToolName,
     arguments: z.record(z.string(), z.unknown()).default({}),
 });
 export const ExecuteToolInput = TestToolInput;
@@ -325,8 +299,7 @@ export const FlowNode = z.discriminatedUnion("kind", [
         ...FlowNodeBase,
         kind: z.literal("tool"),
         configuration: z.strictObject({
-            sourceId: IntelId,
-            toolName: z.string().min(1).max(240),
+            toolName: ToolName,
             fingerprint: z
                 .string()
                 .regex(/^[a-f0-9]{64}$/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/intel-contract",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {