@kernl-sdk/protocol 0.2.0 → 0.2.4

package/.turbo/turbo-build.log

@@ -1,5 +1,4 @@
-
-
-> @kernl-sdk/protocol@0.1.1 build /Users/andjones/Documents/projects/kernl/packages/protocol
-> tsc && tsc-alias
-
+
+> @kernl-sdk/protocol@0.2.3 build /Users/andjones/Documents/projects/kernl/packages/protocol
+> tsc && tsc-alias
+

package/.turbo/turbo-check-types.log

@@ -0,0 +1,4 @@
+
+> @kernl-sdk/protocol@0.2.2 check-types /Users/andjones/Documents/projects/kernl/packages/protocol
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @kernl/protocol
 
+## 0.2.4
+
+### Patch Changes
+
+- Migrate packages from GitHub Packages to npm registry.
+
+  **Breaking change for `kernl` (formerly `@kernl-sdk/core`):**
+
+  The core package has been renamed from `@kernl-sdk/core` to `kernl`. Update your imports:
+
+  ```diff
+  - import { Agent, Kernl } from "@kernl-sdk/core";
+  + import { Agent, Kernl } from "kernl";
+  ```
+
+  All other packages remain under the `@kernl-sdk` scope and are now publicly available on npm.
+
+- Updated dependencies
+  - @kernl-sdk/shared@0.1.5
+
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies
+  - @kernl-sdk/shared@0.1.4
+
+## 0.2.2
+
+### Patch Changes
+
+- 2c62c0a: Migrate from @kernl to @kernl-sdk scope
+
+  All packages have been migrated to the @kernl-sdk scope for publishing to GitHub Packages under the kernl-sdk organization.
+
+- Updated dependencies [2c62c0a]
+  - @kernl-sdk/shared@0.1.3
+
+## 0.2.1
+
+### Patch Changes
+
+- Minor bug fixes and improvements
+- Updated dependencies
+  - @kernl-sdk/shared@0.1.2
+
 ## 0.2.0
 
 ### Minor Changes

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2025 Andrew Jones
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * kernl Provider Protocol
+ * kernl - Protocol
  *
  * Standard interfaces and types for AI model providers.
  */
@@ -7,5 +7,5 @@ export * from "./constants";
 export * from "./language-model";
 export * from "./embedding-model";
 export * from "./provider";
-export * from "./codec";
+export * from "./json";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * kernl Provider Protocol
+ * kernl - Protocol
  *
  * Standard interfaces and types for AI model providers.
  */
@@ -7,4 +7,4 @@ export * from "./constants";
 export * from "./language-model";
 export * from "./embedding-model";
 export * from "./provider";
-export * from "./codec";
+export * from "./json";

package/dist/language-model/item.d.ts

@@ -40,11 +40,9 @@ export interface TextPart extends PartBase {
     text: string;
 }
 /**
- * A file that has been generated by the model.
- *
- * May be base64 encoded strings or binary data.
+ * Base properties for file parts.
  */
-export interface FilePart extends PartBase {
+interface FilePartBase extends PartBase {
     readonly kind: "file";
     /**
      * The IANA media type of the file, e.g. `image/png` or `audio/mp3`.
@@ -53,14 +51,40 @@ export interface FilePart extends PartBase {
      */
     mimeType: string;
     /**
-     * Generated file data as base64 encoded strings or binary data.
+     * Optional filename for the file
+     */
+    filename?: string;
+}
+/**
+ * A file with inline data (base64 string or binary).
+ */
+export interface FilePartWithData extends FilePartBase {
+    /**
+     * File data as base64 encoded string or binary data.
      */
     data: string | Uint8Array;
     /**
-     * Optional filename for the file
+     * The `uri` property must be absent when `data` is present.
      */
-    filename?: string;
+    uri?: never;
 }
+/**
+ * A file referenced by URI.
+ */
+export interface FilePartWithUri extends FilePartBase {
+    /**
+     * A URL pointing to the file's content.
+     */
+    uri: string;
+    /**
+     * The `data` property must be absent when `uri` is present.
+     */
+    data?: never;
+}
+/**
+ * A file that has been generated by the model or referenced by URI.
+ */
+export type FilePart = FilePartWithData | FilePartWithUri;
 /**
  * Represents a structured data segment (e.g., JSON) within a message or artifact.
  */
@@ -158,7 +182,7 @@ export interface ToolResult extends LanguageModelItemBase {
     /**
      * Result of the tool call. This is a JSON-serializable object.
      */
-    result: NonNullable<JSONValue>;
+    result: JSONValue | null;
     /**
      * Error message if the tool call failed
      */
@@ -168,4 +192,5 @@ export interface ToolResult extends LanguageModelItemBase {
  * State of a tool call execution.
  */
 export type ToolCallState = typeof IN_PROGRESS | typeof COMPLETED | typeof FAILED | typeof INTERRUPTIBLE | typeof UNINTERRUPTIBLE;
+export {};
 //# sourceMappingURL=item.d.ts.map

package/dist/language-model/item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/language-model/item.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/language-model/item.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernl-sdk/protocol",
-  "version": "0.2.0",
+  "version": "0.2.4",
   "description": "Protocol specification for kernl",
   "keywords": [
     "kernl",
@@ -12,14 +12,17 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/dremnik/kernl.git",
+    "url": "https://github.com/kernl-sdk/kernl.git",
     "directory": "packages/protocol"
   },
-  "homepage": "https://github.com/dremnik/kernl#readme",
+  "homepage": "https://github.com/kernl-sdk/kernl#readme",
   "bugs": {
-    "url": "https://github.com/dremnik/kernl/issues"
+    "url": "https://github.com/kernl-sdk/kernl/issues"
   },
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -27,7 +30,7 @@
     }
   },
   "dependencies": {
-    "@kernl-sdk/shared": "0.1.1"
+    "@kernl-sdk/shared": "0.1.5"
   },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * kernl Provider Protocol
+ * kernl - Protocol
  *
  * Standard interfaces and types for AI model providers.
  */
@@ -8,4 +8,4 @@ export * from "./constants";
 export * from "./language-model";
 export * from "./embedding-model";
 export * from "./provider";
-export * from "./codec";
+export * from "./json";

package/src/language-model/item.ts

@@ -62,11 +62,9 @@ export interface TextPart extends PartBase {
 }
 
 /**
- * A file that has been generated by the model.
- *
- * May be base64 encoded strings or binary data.
+ * Base properties for file parts.
  */
-export interface FilePart extends PartBase {
+interface FilePartBase extends PartBase {
   readonly kind: "file";
 
   /**
@@ -77,16 +75,46 @@ export interface FilePart extends PartBase {
   mimeType: string;
 
   /**
-   * Generated file data as base64 encoded strings or binary data.
+   * Optional filename for the file
+   */
+  filename?: string;
+}
+
+/**
+ * A file with inline data (base64 string or binary).
+ */
+export interface FilePartWithData extends FilePartBase {
+  /**
+   * File data as base64 encoded string or binary data.
    */
   data: string | Uint8Array;
 
   /**
-   * Optional filename for the file
+   * The `uri` property must be absent when `data` is present.
    */
-  filename?: string;
+  uri?: never;
+}
+
+/**
+ * A file referenced by URI.
+ */
+export interface FilePartWithUri extends FilePartBase {
+  /**
+   * A URL pointing to the file's content.
+   */
+  uri: string;
+
+  /**
+   * The `data` property must be absent when `uri` is present.
+   */
+  data?: never;
 }
 
+/**
+ * A file that has been generated by the model or referenced by URI.
+ */
+export type FilePart = FilePartWithData | FilePartWithUri;
+
 /**
  * Represents a structured data segment (e.g., JSON) within a message or artifact.
  */
@@ -214,7 +242,7 @@ export interface ToolResult extends LanguageModelItemBase {
   /**
    * Result of the tool call. This is a JSON-serializable object.
    */
-  result: NonNullable<JSONValue>;
+  result: JSONValue | null;
 
   /**
    * Error message if the tool call failed

package/src/codec.ts

@@ -1,22 +0,0 @@
-/**
- * Bidirectional codec for converting between kernl protocol types and provider-specific types.
- *
- * @example
- * ```typescript
- * const tools: Codec<LanguageModelTool[], ProviderTool[]> = {
- *   encode: (tools: Tool[]) => tools.map(convertToProvider),
- *   decode: () => { throw new Error("codec:unimplemented"); },
- * };
- * ```
- */
-export interface Codec<TKernl, TProvider> {
-  /**
-   * Transform from kernl protocol format to provider format.
-   */
-  encode: (value: TKernl) => TProvider;
-
-  /**
-   * Transform from provider format to kernl protocol format.
-   */
-  decode: (value: TProvider) => TKernl;
-}