@nestjs-adk/core 0.0.1

package/dist/lib/types/events.d.ts

@@ -0,0 +1,113 @@
+export interface TokenUsage {
+    promptTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cachedTokens?: number;
+}
+export interface RawRef {
+    event?: unknown;
+    response?: unknown;
+}
+export type AgentEvent = {
+    type: "run_start";
+    agent: string;
+    sessionId?: string;
+    raw?: RawRef;
+} | {
+    type: "llm_response";
+    agent: string;
+    text?: string;
+    usage?: TokenUsage;
+    raw?: RawRef;
+} | {
+    type: "tool_call";
+    agent: string;
+    callId: string;
+    tool: string;
+    args: unknown;
+    raw?: RawRef;
+} | {
+    type: "tool_result";
+    agent: string;
+    callId: string;
+    tool: string;
+    result: unknown;
+    raw?: RawRef;
+} | {
+    type: "agent_transfer";
+    from: string;
+    to: string;
+    raw?: RawRef;
+} | {
+    type: "model_rerouted";
+    from: string;
+    to: string;
+    reason: string;
+    raw?: RawRef;
+} | {
+    type: "approval_required";
+    agent: string;
+    callId: string;
+    tool: string;
+    args: unknown;
+    raw?: RawRef;
+} | {
+    type: "final";
+    agent: string;
+    text: string;
+    usage: TokenUsage;
+    raw?: RawRef;
+};
+export interface RunInput {
+    message: string;
+    sessionId?: string;
+    userId?: string;
+    state?: Record<string, unknown>;
+    attributes?: Record<string, unknown>;
+    labels?: Record<string, string>;
+    signal?: AbortSignal;
+    history?: SessionEvent[];
+}
+export interface PendingApproval {
+    callId: string;
+    tool: string;
+    args: unknown;
+    agent: string;
+}
+export interface RunResult<TOutput = unknown> {
+    text: string;
+    output?: TOutput;
+    usage: TokenUsage;
+    events: AgentEvent[];
+    status: "completed" | "pending_approval";
+    pending?: PendingApproval[];
+}
+export interface SessionEvent {
+    v: 1;
+    id: string;
+    at: number;
+    author: "user" | "agent" | "system" | "tool";
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface Session {
+    id: string;
+    userId?: string;
+    state: Record<string, unknown>;
+    events: SessionEvent[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface SessionInit {
+    id?: string;
+    userId?: string;
+    state?: Record<string, unknown>;
+}
+export interface ArtifactRef {
+    sessionId: string;
+    name: string;
+}
+export interface ArtifactPart {
+    mimeType: string;
+    data: string;
+}

package/dist/lib/types/options.d.ts

@@ -0,0 +1,44 @@
+import type { Type } from "@nestjs/common";
+import type { ZodObject, ZodRawShape } from "zod";
+import type { AdkAgent } from "../abstracts/adk-agent";
+import type { AdkSkill } from "../abstracts/adk-skill";
+import type { AdkTool } from "../abstracts/adk-tool";
+import type { SessionStore } from "../abstracts/session-store";
+import type { ToolContext } from "./tool-context";
+export type ModelInput = string | object;
+export type AnyZodObject = ZodObject<ZodRawShape>;
+export interface AgentOptions {
+    name: string;
+    description: string;
+    model?: ModelInput;
+    prompt?: string | Type<import("../prompts/adk-prompt").AdkPrompt>;
+    promptFile?: string;
+    tools?: Array<Type<AdkTool<AnyZodObject>> | import("./toolset").ToolsetRef>;
+    skills?: Type<AdkSkill>[];
+    subAgents?: Type<AdkAgent>[];
+    session?: Type<SessionStore>;
+    output?: ZodObject<ZodRawShape>;
+    outputKey?: string;
+    context?: import("../models/context-policy").ContextPolicy;
+}
+export interface ToolOptions<S extends AnyZodObject = AnyZodObject> {
+    name?: string;
+    description: string;
+    schema: S;
+    requiresApproval?: boolean | ((input: unknown, ctx: ToolContext) => boolean | Promise<boolean>);
+    offload?: boolean;
+}
+export type SkillMode = "on-demand" | "always";
+export interface SkillOptions {
+    name: string;
+    description: string;
+    mode?: SkillMode;
+}
+export type WorkflowMode = "sequential" | "parallel" | "loop";
+export interface WorkflowOptions {
+    name: string;
+    description?: string;
+    mode: WorkflowMode;
+    agents: Type<AdkAgent | object>[];
+    maxIterations?: number;
+}

package/dist/lib/types/resolved-agent.d.ts

@@ -0,0 +1,22 @@
+import type { AnyZodObject, ModelInput, WorkflowMode } from "./options";
+export interface ResolvedTool {
+    name: string;
+    description: string;
+    schema: AnyZodObject;
+    execute(input: unknown): Promise<unknown>;
+}
+export interface ResolvedAgent {
+    name: string;
+    description: string;
+    instruction?: string;
+    model?: ModelInput;
+    tools: ResolvedTool[];
+    subAgents: ResolvedAgent[];
+    workflow?: {
+        mode: WorkflowMode;
+        agents: ResolvedAgent[];
+        maxIterations?: number;
+    };
+    outputSchema?: AnyZodObject;
+    context?: import("../models/context-policy").ContextPolicy;
+}

package/dist/lib/types/tool-context.d.ts

@@ -0,0 +1,15 @@
+export interface ToolContext {
+    agentName: string;
+    sessionId?: string;
+    userId?: string;
+    state: StateBag;
+    attributes: Record<string, unknown>;
+    signal: AbortSignal;
+    actions: {
+        endRun(): void;
+    };
+}
+export interface StateBag {
+    get<T = unknown>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+}

package/dist/lib/types/toolset.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedTool } from "./resolved-agent";
+export interface ToolsetRef {
+    readonly __adkToolset: string;
+    filter?: string[];
+}
+export declare function toolset(name: string, filter?: string[]): ToolsetRef;
+export declare function isToolsetRef(value: unknown): value is ToolsetRef;
+export declare abstract class ToolsetResolver {
+    abstract resolve(ref: ToolsetRef): Promise<ResolvedTool[]>;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@nestjs-adk/core",
+	"version": "0.0.1",
+	"description": "NestJS-native agent framework: decorators, DI and abstract contracts over pluggable AI agent engines (Google ADK first).",
+	"license": "MIT",
+	"sideEffects": false,
+	"main": "dist/index.cjs",
+	"module": "dist/index.mjs",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.cjs"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": ["dist"],
+	"engines": {
+		"node": ">=20"
+	},
+	"scripts": {
+		"prebuild": "rimraf -g dist",
+		"build": "rollup -c"
+	},
+	"peerDependencies": {
+		"@nestjs/common": "^10.0.0 || ^11.0.0",
+		"@nestjs/core": "^10.0.0 || ^11.0.0",
+		"reflect-metadata": "^0.1.13 || ^0.2.0",
+		"zod": "^3.23.0 || ^4.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}