zuzu 0.2.1-java → 0.2.3-java

data/templates/app.rb

@@ -2,24 +2,62 @@
 
 require 'zuzu'
 
-# ── Configure ────────────────────────────────────────────────────
-# Paths are automatically expanded to absolute, so relative paths work fine.
+# ── 1. Configure ─────────────────────────────────────────────────────────────
 Zuzu.configure do |c|
-  c.app_name       = 'My Assistant'
-  # When running from a packaged jar, __dir__ is a classloader URI —
-  # resolve paths against the directory where the jar was launched instead.
+  c.app_name      = 'My Assistant'     # Window title
+  c.window_width  = 860
+  c.window_height = 620
+  c.port          = 8080               # llamafile API port
+
+  # Works both when run directly and when packaged as a .jar
   base = __dir__.to_s.start_with?('uri:classloader:') ? Dir.pwd : __dir__
   c.llamafile_path = File.join(base, 'models', 'your-model.llamafile')
   c.db_path        = File.join(base, '.zuzu', 'zuzu.db')
-  c.port           = 8080
-  # c.channels     = ['whatsapp']
+
+  # ── Extra system prompt instructions (optional) ─────────────────────────
+  # Append domain-specific behaviour, persona, or constraints to the agent's
+  # system prompt. The built-in tool list is always included automatically.
+  c.system_prompt_extras = <<~EXTRA
+    You are a personal assistant for a software developer named Alex.
+    Always prefer concise, technical answers.
+    When writing code, use Ruby unless the user asks for another language.
+  EXTRA
 end
 
-# ── Custom Tools ─────────────────────────────────────────────────
+# ── 2. Custom tools ──────────────────────────────────────────────────────────
+# Register tools the agent can call during conversations.
+# The agent discovers them automatically — no prompt editing needed.
+#
+# Block signature: |args_hash, agent_fs|
+#   args_hash — the JSON args the model passed (string keys)
+#   agent_fs  — Zuzu::AgentFS instance for sandboxed file/KV access
+
 Zuzu::ToolRegistry.register(
-  'greet', 'Greet a user by name.',
+  'current_time',
+  'Get the current local date and time.',
+  { type: 'object', properties: {}, required: [] }
+) { |_args, _fs| Time.now.strftime('%Y-%m-%d %H:%M:%S %Z') }
+
+Zuzu::ToolRegistry.register(
+  'greet',
+  'Greet a user by name.',
   { type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }
-) { |args, _fs| "Hello, #{args['name']}!" }
+) { |args, _fs| "Hello, #{args['name']}! Welcome." }
+
+# ── 3. UI customisation ──────────────────────────────────────────────────────
+# Basic customisation (app name, window size) is handled via Zuzu.configure above.
+#
+# For deeper UI changes subclass Zuzu::App and call launch! on your subclass:
+#
+#   class MyApp < Zuzu::App
+#     # Override private helpers, e.g. change the Admin Panel contents:
+#     def open_admin_panel
+#       super   # keep default panel, or replace entirely
+#     end
+#   end
+#   MyApp.launch!(use_llamafile: true)
+#
+# See lib/zuzu/app.rb in the zuzu gem source for the full shell/body definition.
 
-# ── Launch ───────────────────────────────────────────────────────
+# ── Launch ───────────────────────────────────────────────────────────────────
 Zuzu::App.launch!(use_llamafile: true)

data/warble.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Warbler configuration for packaging Zuzu apps as standalone .jar / .war.
+# Usage:  warble jar
+#
+# The resulting .jar can be run with:
+#   java -XstartOnFirstThread -jar my_app.jar   (macOS)
+#   java -jar my_app.jar                        (Linux / Windows)
+
+Warbler::Config.new do |config|
+  config.features  = %w[executable]
+  config.dirs      = %w[lib templates]
+  config.includes  = FileList['app.rb', 'Gemfile']
+  # models/ is NOT bundled — place model files next to the jar at runtime
+
+  # SWT native fragments are pulled in by glimmer-dsl-swt;
+  # Warbler bundles them automatically.
+  config.bundler   = true
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zuzu
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: java
 authors:
 - Abhishek Parolkar
@@ -41,46 +41,55 @@ dependencies:
   name: webrick
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
 - !ruby/object:Gem::Dependency
   name: bigdecimal
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: Zuzu is a framework for building local-first, privacy-respecting desktop
-  AI assistants using JRuby, Glimmer DSL for SWT, SQLite, and llamafile.
+        version: '1.5'
+description: Every installed application is an orchestrator of OS capabilities. LLMs
+  are simply a more expressive interface for that orchestration. Zuzu is a framework
+  for building installable, AI-native desktop apps where the intelligence runs on
+  the user's hardware — not in a data center. It uses JRuby and Glimmer DSL for SWT
+  for the GUI, Mozilla's llamafile for local LLM inference, and SQLite (via AgentFS)
+  as a sandboxed virtual filesystem the agent can read and write without touching
+  the host OS. Apps ship as a cross-platform .jar, or as a native installer (.dmg/.deb/.exe)
+  with a JRE bundled via jpackage — users download, double-click, and run with no
+  Java installation required. No cloud. No subscriptions. No infrastructure to operate.
+  Scaffolded projects include CLAUDE.md and Claude Code skills pre-tuned to Zuzu's
+  patterns, so coding agents generate correct framework code from the start.
 email:
 - abhishek@parolkar.com
 executables:
@@ -109,13 +118,20 @@ files:
 - lib/zuzu/tools/shell_tool.rb
 - lib/zuzu/tools/web_tool.rb
 - lib/zuzu/version.rb
+- templates/.claude/skills/add-tool/SKILL.md
+- templates/.claude/skills/customize/SKILL.md
+- templates/.claude/skills/debug/SKILL.md
+- templates/.claude/skills/setup/SKILL.md
+- templates/AGENTS.md
+- templates/CLAUDE.md
 - templates/app.rb
+- warble.rb
 homepage: https://github.com/parolkar/zuzu
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/parolkar/zuzu
-  source_code_uri: https://github.com/parolkar/zuzu
+  source_code_uri: https://github.com/parolkar/zuzu/tree/main
   bug_tracker_uri: https://github.com/parolkar/zuzu/issues
 rdoc_options: []
 require_paths:
@@ -133,5 +149,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.7.2
 specification_version: 4
-summary: Local-first agentic desktop apps with JRuby.
+summary: JRuby framework for AI-native desktop apps — local LLM, single .jar/.dmg/.exe/.deb
+  distribution, Claude Code-ready scaffolding. SQLite-backed AgentFS as a sandboxed
+  virtual filesystem for the agent. No cloud required.
 test_files: []