@hanfani/core 0.1.1 → 0.1.3

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Aziz Mashkour
+Copyright (c) 2026 Fruitizz
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,46 +2,40 @@
 
 Headless engine and types for the Hanfani agent framework.
 
-Pure logic — no I/O, no server, no React. This is the layer that defines what a
-workflow and an agent *are* and enforces the framework's one safety invariant:
-
-> An agent proposes, a human approves, the server acts.
-
-`defineAgent` refuses any `effect` that isn't also an `approval`, so a side
-effect can never be wired to fire without a human gate. `providerConformanceChecks`
-proves any provider honours that at runtime.
-
-## Exports
-
-- **Definitions:** `defineAgent`, `defineWorkflow`, `definePrompt`,
-  `defineProviders`, `AgentDefinitionSchema`.
-- **Messages:** `isAssistant`, `isToolMessage`, `toolCallsOf`,
-  `hasPendingApproval`, `pairToolResults`, `lastApprovalArgs`,
-  `resolvedApprovalCount`, `approvalResolved`.
-- **Handoffs:** `encodeHandoff`, `decodeHandoff`, `handoffNote`,
-  `HandoffPayloadSchema`, `TicketHandoffPayloadSchema`.
-- **Gates & events:** `gateOpened`, `readGateOpened`, `GATE_OPENED`,
-  `GateOpenedValueSchema`, `lifecycleNote`, `LIFECYCLE_NOTE_TEXT`,
-  `foldEventsToMessages`.
-- **Lifecycle & delivery:** `lifecycle`, `hasLiveDescendant`, `resolveDelivery`,
-  `instanceId`, `composeInstructions`.
-- **Providers & integration:** `providerConformanceChecks`, `aggregateHealth`,
-  `isOk`, `isOAuth2`.
-- Plus the full type surface (`WorkflowDescriptor`, `Outcome`, `Phase`,
-  `Provider`, `EffectFn`, `AuthSpec`, `ResolvedCredential`, …).
-
-## Build & test
-
-Built with the native TypeScript 7 compiler (`tsc` / tsgo) — no bundler, no
-compiler-API tooling, so nothing here breaks on the TS 7 upgrade.
+Pure logic — no I/O, no server, no UI. It defines what a workflow and an agent
+*are* and enforces one rule:
+
+> **The agent proposes, a human approves, the server acts.**
+
+`defineAgent` refuses any side effect that isn't behind a human-approval gate,
+and `providerConformanceChecks` proves any model provider honors that at runtime.
+
+## Install
 
 ```bash
-pnpm build       # tsc -p tsconfig.build.json → dist/*.js + dist/*.d.ts
-pnpm typecheck   # tsc -p tsconfig.json --noEmit
-pnpm test        # vitest smoke suite
+pnpm add @hanfani/core
 ```
 
-## Peer runtime
+## Quick look
+
+```ts
+import { defineAgent } from '@hanfani/core'
+
+const reply = defineAgent({
+  id: 'reply',
+  name: 'Reply',
+  provider: 'claude',
+  instructions: 'Draft a reply for the human to approve.',
+  tools: ['saveDraft'],
+  approvals: ['saveDraft'], // saveDraft only fires after a human approves
+  renders: { saveDraft: 'DraftCard' },
+})
+```
+
+## Docs
+
+Full API reference and guides are coming soon in the Hanfani framework docs.
+
+## License
 
-Depends on `@ag-ui/client` (event/message types) and `zod` (schemas). Both are
-declared as regular dependencies.
+[MIT](./LICENSE) License © [Fruitizz](https://github.com/fruitizz)

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@hanfani/core",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Headless engine and types for the Hanfani agent framework.",
   "license": "MIT",
-  "author": "Aziz Mashkour",
+  "author": "Fruitizz",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -19,10 +19,13 @@
   "publishConfig": {
     "access": "public"
   },
+  "homepage": "https://github.com/fruitizz/hanfani-core#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/azizmashkour/hanfani-packages.git",
-    "directory": "packages/core"
+    "url": "git+https://github.com/fruitizz/hanfani-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fruitizz/hanfani-core/issues"
   },
   "keywords": [
     "hanfani",
@@ -35,6 +38,13 @@
     "@ag-ui/client": "^0.0.55",
     "zod": "^3.25.76"
   },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^2.1.0"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",